Início/Comprar via API

Compre Bandwidth da TRON via API

Ver documentação →

Bandwidth é o recurso que a TRON cobra por transferências padrão e chamadas de contrato que não alteram o storage de um smart contract — o caso mais comum é uma transferência simples de TRX. Chame um endpoint com um endereço de destino e um volume, e delegamos Bandwidth 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": "bandwidth", "targetAddress": "TXYZ...4f9a", "volume": 1000, "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. Bandwidth: 1.000–300.000. Energy: 65.000–1.000.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.

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

Uma transferência padrão de TRX usa cerca de 267 Bandwidth. Outros tipos de transferência podem precisar de um pouco mais — nosso pedido mínimo de 1.000 cobre várias transferências com folga.

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 (1.000 Bandwidth, 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.