Início/Comprar via API

Alugue Energy da TRON via API

Ver documentação →

Energy é o recurso que a rede TRON consome quando uma transação executa um smart contract — o caso mais comum é uma transferência de USDT (TRC-20). Chame um endpoint com um endereço de destino e um volume, e delegamos Energy diretamente para ele.

import requests resp = requests.post( "https://trongas.ai/api/v1/orders", headers={ "X-Api-Key": "tgk_4f9a1c8e2b7d...", "Idempotency-Key": "5c1e2b6a-9e21-4b7a-8f3d-1a2b3c4d5e6f", }, json={ "resource": "energy", "targetAddress": "TXYZ...4f9a", "volume": 65000, "duration": "1h", }, ) print(resp.json())

Formato da solicitação

Corpo da solicitação
resourcestring

"energy" ou "bandwidth". O padrão é energy se omitido.

targetAddressstring

Endereço TRON que recebe o recurso delegado.

volumeinteger

Quantidade a delegar. Energy: 65.000–1.000.000. Bandwidth: 1.000–300.000.

durationstring

"15m", "1h" ou "1d".

Cabeçalhos
X-Api-Key

Sua API key.

Idempotency-Key

Um UUID gerado por você. Tentar novamente com a mesma chave retorna a ordem original em vez de cobrar duas vezes.

Corpo da resposta
id

ID da ordem.

status

"Created" no início, depois "Filled" assim que delegado (ou "Failed"). Assine o webhook order.filled para saber o momento exato em que é concluído.

priceTrx / activationTrx / totalTrx

Cobrança em TRX. activationTrx só é diferente de zero quando o endereço de destino recebe TRX pela primeira vez.

txId

Hash da transação de delegação, preenchido assim que a ordem é concluída.

Obter uma API key

Do zero à sua primeira solicitação

01
Cadastre-se
Crie uma conta gratuita na TronGasAi.
02
Obtenha sua API key
Emita uma chave com escopo definido no painel.
03
Envie uma solicitação de teste
Chame POST /orders com sua chave.
04
Conecte ao seu projeto
Integre essa mesma chamada no seu app ou serviço.

Perguntas frequentes

Cerca de 65.000 de Energy se o endereço do destinatário tem USDT no momento, e cerca de 131.000 se o saldo de USDT dele for zero (o contrato precisa criar um novo registro de saldo). Só importa o saldo atual de USDT do destinatário — não se o endereço é novo ou pertence a uma exchange.

A ordem é rejeitada antes de qualquer cobrança (402, wallet.insufficient_balance) — recarregue seu saldo interno em TRX e tente novamente com a mesma Idempotency-Key.

Se o provedor não conseguir cumprir a ordem, a cobrança é reembolsada automaticamente para o seu saldo interno — sem necessidade de acompanhamento manual.

Ainda não — toda ordem usa seu saldo interno real em TRX. Comece com o menor volume (65.000 de Energy, 15 minutos) para testar o fluxo completo com custo mínimo.

A resposta retorna imediatamente com status "Created". Registre um webhook para order.filled (ou consulte a ordem) para saber exatamente quando a delegação é concluída — geralmente cerca de 0,3s depois.