Tovanix
Tovanix

API de aluguel de energia TRON

Alugue energia TRON por programação em vez de consumir TRX em taxas — 70–80% mais barato por transferência TRC-20.

  • Pedidos: informe o endereço do destinatário, a quantidade de energia e o prazo do aluguel; a delegação chega em segundos
  • Consulta de pedidos: consulte o status e o vencimento da delegação por ID do pedido ou endereço
  • Preços: preço unitário e faixas em tempo real para planejar custos
  • Webhooks: eventos de delegação bem-sucedida e vencimento, assinados com HMAC

GET / POST /api/v1/energy/*

Autenticação

A API de aluguel de energia usa chave de API do usuário para autenticar. Inclua estes cabeçalhos em cada requisição:

Entre no console → Ferramentas e configurações → Gerenciamento de API e crie e ative uma chave para obter X-API-Key e X-Secret-Key.

Chamadas assinadas para endpoints com cobrança

Criar um pedido, criar um pedido avulso e recuperar são endpoints com cobrança. Novas chaves de API exigem requisições assinadas por padrão (X-Key-ID / X-Timestamp / X-Nonce / X-Sign-Version / X-Signature); abaixo há um exemplo completo de criação de pedido. Endpoints de consulta continuam aceitando somente X-API-Key + X-Secret-Key. Se você desativar "Exigir requisições assinadas para cobranças e dados sensíveis" nas configurações da chave, endpoints com cobrança também aceitam X-Secret-Key em texto simples, mas não é recomendado.

Visão geral

Transferências de USDT em TRON consomem energia. Endereços sem TRX congelado pagam ~6,5–13 TRX de Gas por transação. Com energia alugada, a transferência usa essa energia em vez de queimar TRX; quanto você economiza depende do preço do aluguel no momento do pedido.

Transferir USDT para endereço com saldo USDT existente: ~65.000 de energia

Transferir USDT para endereço que nunca recebeu: ~135.000 de energia

Obter informações da plataforma

GET /api/v1/energy/info

Obtenha informações públicas do aluguel: energia disponível, níveis de preços e limites.

Consultar saldo da conta

GET /api/v1/energy/balance

Consulte o saldo da conta desta chave. Aluguel de energia tem alta frequência e baixo valor, podendo consumir o saldo rotineiramente — consulte antes de lotes e configure alerta de saldo baixo.

Listar períodos de aluguel (endpoint)

GET /api/v1/energy/periods

Retorna os períodos suportados. Valores fora da lista são recusados com 400, sem criar pedido.

Estimativa de preço

GET /api/v1/energy/price

Estime o custo para um período e quantidade. Retorna preço específico da API (TRX).

Estimar consumo de energia

GET /api/v1/energy/estimate-energy

Estime a energia necessária para enviar USDT a um endereço.

Criar pedido de aluguel

POST /api/v1/energy/order

Crie um pedido de aluguel; a taxa sai do saldo da conta (USD).

Campos da resposta

Retorna code: 400, message: "Insufficient account balance, please top up first" quando o saldo é insuficiente

Pedido único de energia

POST /api/v1/energy/order/onetime

Crie um pedido pela estratégia por transação; energy_amount é atribuído automaticamente pelo sistema.

Consultar lista de pedidos

GET /api/v1/energy/orders

Consulte seus pedidos de aluguel de energia.

Consultar um pedido

GET /api/v1/energy/order/:serial

Consulte os detalhes e sincronize o status mais recente.

Consultar pedido pelo seu número de transação

GET /api/v1/energy/order/by-trade-no/:out_trade_no

Busque pelo seu out_trade_no — sem precisar do nosso número de série.

⚠️ Se a criação do pedido exceder o tempo, ela retorna 504 e você só tem out_trade_no (nosso número de série não aparece nessa resposta). Este endpoint existe para esse caso: busque o resultado final com o mesmo out_trade_no.

Recolher pedido

POST /api/v1/energy/order/reclaim

Recolha antecipadamente um aluguel ainda vigente.

Callback do resultado do pedido

Para pedidos criados com callback_url (incluindo pedidos avulsos), a plataforma envia o resultado a essa URL uma vez, quando o pedido é definido pela primeira vez como concluído (status=40) ou falhou (status=41). Seja por notificação de status em tempo real, consulta do pedido, conciliação ou recuperação de um pedido que não pôde ser salvo, cada pedido é notificado uma única vez, e entregas malsucedidas são repetidas automaticamente. A exceção é um pedido cuja criação retornou 504 com resultado desconhecido (registrado internamente como um pedido provisório com serial iniciado por LOCAL-): ele é resolvido manualmente e nunca notificado automaticamente; confirme o resultado consultando pelo seu número de pedido. Os callbacks são enviados e assinados pela plataforma; o formato de callback antigo não é mais usado, portanto integrações existentes devem atualizar a análise e a verificação de assinatura conforme esta seção.

A requisição é um POST com Content-Type: application/json. O corpo é um objeto JSON plano em que todos os valores são strings (incluindo status, energy_amount e timestamp), sem campos de preço. A plataforma não segue redirecionamentos, e cada requisição tem timeout de 10 segundos.

Verificação da assinatura

O algoritmo é o mesmo dos callbacks de pedidos de pagamento: use todos os campos com valor não vazio, exceto sign, ordene pelos nomes em ordem ASCII, concatene como k1=v1&k2=v2&… e calcule HMAC-SHA256; o resultado é hexadecimal em minúsculas. A chave é a Secret Key da chave de API usada no pedido; para pedidos com credenciais de aplicativo de pagamento, é o Push Secret do aplicativo (WebhookSecret, exibido na página de detalhes do aplicativo no console — a mesma chave dos callbacks de pagamento); aplicativos antigos que nunca geraram um Push Secret usam a App Key.

A notificação não contém sign quando o pedido foi criado pelo suporte da plataforma em seu nome (não há chave correspondente) ou quando a chave de API ou o aplicativo de pagamento usado no pedido foi excluído. Ao receber uma notificação sem sign, confirme o status pelo endpoint de consulta antes de agir.

Resposta e novas tentativas

Qualquer código 2xx conta como entregue; o corpo da resposta não é verificado. Um status fora de 2xx, timeout, falha de conexão ou redirecionamento conta como falha; a plataforma tenta novamente após 30 segundos, 1 minuto, 2 minutos e 5 minutos e, depois, a cada 10 minutos, até 10 novas tentativas (encerra após cerca de 70 minutos). As novas tentativas enviam exatamente o mesmo corpo, incluindo notify_id e sign.

Se a conexão cair após seu servidor processar uma notificação, mas antes de a plataforma receber o 2xx, o mesmo pedido será notificado novamente. Deduplicate por notify_id ou serial e garanta que processar duas vezes não produza efeitos adicionais. A notificação não é a única fonte do resultado: se você nunca a receber ou a entrega falhar definitivamente, confirme por GET /api/v1/energy/order/:serial ou pela consulta com seu número de pedido.

Períodos de aluguel

Estes são todos os períodos atualmente suportados. Consulte também GET /api/v1/energy/periods. Outros valores retornam 400, sem criar pedido.

Perguntas frequentes

Quanto a API de aluguel de energia realmente economiza?

Consumir TRX diretamente em uma transferência de USDT TRC-20 costuma custar cerca de 6,5-13 TRX. Alugar energia reduz esse custo em 70–80%, e a diferença aumenta em transferências em lote.

Qual é a velocidade da delegação e posso usar outro endereço?

A delegação chega em segundos, e o endereço do destinatário é o informado na solicitação — não precisa ser o da conta que fez o pedido, permitindo fornecer energia em lote a qualquer endereço comercial.

Páginas relacionadas: Aluguel de energia TRON · Documentação da API · Pagamentos com cripto em várias redes

Carregando…