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…