Esta página também está disponível em inglês.
TronEnergyFrog

Desenvolvedores · REST e x402

API de aluguel de energia TRON

Três chamadas alugam energia pelo seu backend: POST /v1/quotes/energy fixa um preço, POST /v1/rental faz o aluguel e GET /v1/operations/{id} confirma a entrega. As tarifas públicas não exigem chave. Bots e agentes de IA sem conta podem pagar por aluguel em USDC com x402.

Nesta página
  1. Para quem é
  2. API com conta ou x402
  3. Alugar com a API com conta
  4. Tarifas públicas, sem chave
  5. x402: pague em USDC
  6. Acompanhar a entrega
  7. Perguntas sobre a API
# 1. Fixe um preço para 65.000 de energia, 1 hora
curl -X POST https://api.tronenergyfrog.com/v1/quotes/energy \
  -H "Authorization: Bearer $TEF_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"energy_amount":65000,"duration_seconds":3600,
       "target_address":"TQ5nW3…8k2Wd"}'
# → { "quote_id": "1111…", "price_trx": "…", … }

# 2. Alugue. Novas tentativas com a mesma chave nunca alugam duas vezes.
curl -X POST https://api.tronenergyfrog.com/v1/rental \
  -H "Authorization: Bearer $TEF_API_KEY" \
  -H "Idempotency-Key: payout-2026-0042" \
  -H "Content-Type: application/json" \
  -d '{"quote_id":"1111…"}'
# → 202 Accepted · Location: /v1/operations/3333…

# 3. Acompanhe a entrega
curl https://api.tronenergyfrog.com/v1/operations/3333… \
  -H "Authorization: Bearer $TEF_API_KEY"
# → { "status": "succeeded", "txid": "…" }
Exemplo resumido; endereços e IDs são fictícios.Esquemas completos na referência
Chamadas para alugar energia
3Cotar, alugar, acompanhar
65K de energia, 1 hora, hoje
1,55 TRX≈ US$ 0,47 contra 6,50 TRX queimados
Conta necessária para x402
0Pague por aluguel em USDC
A cotação x402 fixa o preço por
10 minutosPreço da energia e cotação TRX/USD

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.

Corretoras e carteiras

Alugue energia para a hot wallet antes de cada lote de saques.

Sistemas de pagamento e repasse

Um aluguel idempotente por repasse, identificado pelo ID do seu repasse.

Bots e agentes de IA

Nenhuma conta com x402: cote, pague em USDC, consulte o status.

API com conta ou x402: qual usar?

API com contax402
CadastroConta com uma chave de APINenhum: sem conta, sem chave de API
PagamentoSaldo pré-pago em TRXUSDC na Base (preferencial) ou na Solana, por aluguel
Fixação do preçoAté o valid_until da cotação10 minutos, preço da energia e cotação TRX/USD
AcompanhamentoGET /v1/operations/{id}O status_url da cotação
Ideal paraVolume constante, uma única cobrançaAgentes, scripts avulsos, sem saldo armazenado

Como alugar energia TRON com a API com conta

  1. 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>.

  2. Fixe um preço

    POST /v1/quotes/energy com energy_amount, duration_seconds (3600 ou 86400) e o target_address que vai enviar o USDT. A resposta traz quote_id, price_trx, valid_until e a economia estimada em relação à queima.

  3. Alugue com a cotação

    POST /v1/rental com o quote_id e um cabeçalho Idempotency-Key. Os fundos são reservados do seu saldo e o aluguel entra na fila; a resposta é 202 com um Location apontando para a operação.

  4. 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.

POST/v1/quotes/energyFixar um preço
POST/v1/rentalAlugar energia
GET/v1/operations/{id}Acompanhar a entrega

Quantidades 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.

Exemplo de resposta · valores ilustrativos · average_commission_trx = TRX queimado sem energia
{
  "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.

  1. Leia o endpoint de recursos

    GET /v1/x402 lista os endpoints atuais e as redes de pagamento compatíveis.

  2. Crie uma cotação gratuita

    POST /v1/x402/quotes com o target_address (e, opcionalmente, energy_amount e duration_seconds). Ela fixa o preço da energia e a conversão TRX/USD por dez minutos.

  3. Obtenha o desafio de pagamento

    Faça um POST na payment_url retornada uma vez, sem assinatura. A resposta é 402 Payment Required com PAYMENT-REQUIRED.

  4. 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 retorna PAYMENT-RESPONSE.

  5. Consulte a URL de status

    status_url informa tanto a liquidação do pagamento quanto a entrega da energia.

PrioridadeAtivoRedeUso
PreferencialUSDCBasePrimeira escolha para agentes compatíveis
AlternativaUSDCSolanaQuando 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.

StatusO que fazer
queued processing submittedContinue consultando. Não envie USDT ainda.
succeededA energia está no endereço de destino. Envie a transferência enquanto o aluguel estiver ativo.
failedLeia o error_code. Não envie USDT supondo que a energia chegou.
unknownO 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.

Perguntas sobre a API

Ainda com dúvidas? Fale com o suporte e uma pessoa responde.

Preciso de uma conta para usar a API de energia TRON?

Para a API com conta, sim: crie uma chave de API na sua conta. O endpoint público de tarifas e os endpoints x402 não exigem conta nem chave de API.

Como os aluguéis pela API são pagos?

Os aluguéis pela API com conta são pagos com o saldo pré-pago da conta. Os aluguéis x402 são pagos por aluguel em USDC, na Base (preferencial) ou na Solana.

Como evito pagar duas vezes quando uma requisição é repetida?

Envie um cabeçalho Idempotency-Key com POST /v1/rental. Repetir a requisição com a mesma chave não cria um segundo aluguel.

Qual opção de pagamento x402 um bot deve escolher?

USDC na Base quando disponível, USDC na Solana como alternativa. A resposta 402 é a fonte oficial para redes, endereços de tokens, destinatários, expiração e o valor exato.

Onde estão os esquemas completos de requisição e resposta?

Na referência da API, também disponível em OpenAPI JSON e Markdown.

Sobre esta página

Os endpoints e nomes de campos correspondem à referência publicada da API. O código foi resumido para leitura; a referência tem os esquemas e erros completos.

Referência
api.tronenergyfrog.com/v1/docsVersões OpenAPI JSON e Markdown com links lá
Preços
API pública de tarifas, 22 de nov. de 2026, 12:38 UTC
x402
Fluxo de pagamento x402, USDC na Base e na Solana
Revisado
17 de nov. de 2026 · equipe TronEnergyFrog

Alugue seus próximos 65K por 1,55 TRX em vez de queimar 6,50 TRX

Teste um aluguel no site primeiro e depois automatize. Não é preciso conta para alugar como visitante, e nada é cobrado até você pagar.

Sua próxima transferência

Energia necessária
65.000
Sem energia
6,50 TRX queimados ≈ US$ 1,98
Com TronEnergyFrog
1,55 TRX ≈ US$ 0,47
Você economiza
4,95 TRX ≈ US$ 1,51
65K de energia, 1 hora1,55 TRX ≈ US$ 0,47
Alugar energia