Para quem é a API de energia TRON?
Para quem envia USDT na TRON a partir de código, com frequência suficiente para que 6,50 TRX queimados por transferência pesem no bolso.
Alugue energia para a hot wallet antes de cada lote de saques.
Um aluguel idempotente por repasse, identificado pelo ID do seu repasse.
Nenhuma conta com x402: cote, pague em USDC, consulte o status.
API com conta ou x402: qual usar?
| API com conta | x402 | |
|---|---|---|
| Cadastro | Conta com uma chave de API | Nenhum: sem conta, sem chave de API |
| Pagamento | Saldo pré-pago em TRX | USDC na Base (preferencial) ou na Solana, por aluguel |
| Fixação do preço | Até o valid_until da cotação | 10 minutos, preço da energia e cotação TRX/USD |
| Acompanhamento | GET /v1/operations/{id} | O status_url da cotação |
| Ideal para | Volume constante, uma única cobrança | Agentes, scripts avulsos, sem saldo armazenado |
Como alugar energia TRON com a API com conta
- Crie uma chave de API
Entre com Telegram ou Google, abra API e crie uma chave. O valor completo é exibido só uma vez. Envie-a como
Authorization: Bearer <key>. - Fixe um preço
POST /v1/quotes/energycomenergy_amount,duration_seconds(3600 ou 86400) e otarget_addressque vai enviar o USDT. A resposta trazquote_id,price_trx,valid_untile a economia estimada em relação à queima. - Alugue com a cotação
POST /v1/rentalcom oquote_ide um cabeçalhoIdempotency-Key. Os fundos são reservados do seu saldo e o aluguel entra na fila; a resposta é202com umLocationapontando para a operação. - Aguarde a entrega e envie o USDT
Consulte a operação até ela ser concluída e então assine a transferência a partir do endereço de destino.
/v1/quotes/energyFixar um preço/v1/rentalAlugar energia/v1/operations/{id}Acompanhar a entregaQuantidades personalizadasDefina custom_amount como true para quantidades diferentes de 65.000 ou 130.000. O mínimo atual é publicado pela API; a referência explica onde consultá-lo.
Consulte os preços da energia TRON sem chave
GET https://tronenergyfrog.com/api/v1/rates/energy/default retorna o preço público de 65.000 de energia por 1 hora, o TRX que a mesma energia queimaria, a economia e o histórico por hora. Adicione ?history=1d, 7d, 30d ou 90d. As respostas ficam em cache por 30 segundos.
{
"energy_amount": 65000,
"duration_seconds": 3600,
"price_trx": "2.05",
"average_commission_trx": "6.5",
"savings_trx": "4.45",
"savings_percent": "68.46",
"network_fee_updated_at": "2026-11-17T12:00:00Z",
"price_history": {
"window_hours": 168,
"median_price_trx": "1.59",
"current_vs_median_percent": "28.9",
"points": [ … ]
}
}Use-o em painéis e alertas de preço. Para um pedido, sempre solicite uma cotação: a tarifa pública é uma referência, não um preço fixado.
x402: alugue energia TRON com USDC, sem conta
Não é preciso cadastro, conta, chave de API nem saldo pré-pago. Descubra o contrato atual em GET /v1/x402 e siga o fluxo padrão do x402. Os esquemas campo a campo estão na seção x402 da referência da API.
- Leia o endpoint de recursos
GET /v1/x402lista os endpoints atuais e as redes de pagamento compatíveis. - Crie uma cotação gratuita
POST /v1/x402/quotescom otarget_address(e, opcionalmente,energy_amounteduration_seconds). Ela fixa o preço da energia e a conversão TRX/USD por dez minutos. - Obtenha o desafio de pagamento
Faça um POST na
payment_urlretornada uma vez, sem assinatura. A resposta é402 Payment RequiredcomPAYMENT-REQUIRED. - Pague e tente de novo
Pague uma das opções anunciadas com a carteira do agente e repita a mesma URL com
PAYMENT-SIGNATURE. Uma liquidação bem-sucedida retornaPAYMENT-RESPONSE. - Consulte a URL de status
status_urlinforma tanto a liquidação do pagamento quanto a entrega da energia.
| Prioridade | Ativo | Rede | Uso |
|---|---|---|---|
| Preferencial | USDC | Base | Primeira escolha para agentes compatíveis |
| Alternativa | USDC | Solana | Quando o agente tem fundos na Solana |
A resposta 402 é a fonte oficialpara identificadores de rede, endereços de tokens, destinatários, expiração e o valor atômico exato. Os bots devem ler as respostas da API em vez de extrair preços desta página.
Como sei que a energia foi entregue?
Todo aluguel é uma operação. Consulte GET /v1/operations/{id} até ela chegar a um status final; uma operação concluída traz o txid da delegação, que você pode abrir no TronScan.
| Status | O que fazer |
|---|---|
| queued processing submitted | Continue consultando. Não envie USDT ainda. |
| succeeded | A energia está no endereço de destino. Envie a transferência enquanto o aluguel estiver ativo. |
| failed | Leia o error_code. Não envie USDT supondo que a energia chegou. |
| unknown | O resultado ainda não está confirmado. Continue consultando; veja na referência como tratar esse caso. |
Os endpoints de histórico e os IDs de projeto para associar operações aos seus próprios pedidos estão descritos na referência da API.