Inicio/Comprar vía API

Compra Bandwidth de TRON vía API

Ver documentación →

Bandwidth es el recurso que TRON cobra por las transferencias estándar y llamadas a contratos que no modifican el almacenamiento de un smart contract — lo más común, una transferencia simple de TRX. Llama a un endpoint con una dirección destino y un volumen, y delegamos Bandwidth directamente a esa dirección.

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 de la solicitud

Cuerpo de la solicitud
resourcestring

"energy" o "bandwidth". Por defecto es energy si se omite.

targetAddressstring

Dirección TRON que recibe el recurso delegado.

volumeinteger

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

durationstring

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

Cabeceras
X-Api-Key

Tu API key.

Idempotency-Key

Un UUID que generas tú. Reintentar con la misma clave devuelve la orden original en lugar de cobrar dos veces.

Cuerpo de la respuesta
id

ID de la orden.

status

"Created" al inicio, luego "Filled" una vez delegado (o "Failed"). Suscríbete al webhook order.filled para saber el momento exacto en que se completa.

priceTrx / activationTrx / totalTrx

Cargo en TRX. activationTrx solo es distinto de cero cuando la dirección destino recibe TRX por primera vez.

txId

Hash de la transacción de delegación, disponible una vez que la orden se completa.

De cero a tu primera solicitud

01
Regístrate
Crea una cuenta gratuita de TronGasAi.
02
Obtén tu API key
Emite una clave con permisos definidos desde el panel.
03
Envía una solicitud de prueba
Llama a POST /orders con tu clave.
04
Conéctalo a tu proyecto
Integra la misma llamada en tu app o servicio.

Preguntas frecuentes

Una transferencia estándar de TRX usa cerca de 267 Bandwidth. Otros tipos de transferencia pueden necesitar un poco más — nuestro pedido mínimo de 1.000 cubre varias transferencias con margen.

La orden se rechaza antes de cobrar nada (402, wallet.insufficient_balance) — recarga tu saldo interno en TRX y reintenta con la misma Idempotency-Key.

Si el proveedor no puede completar la orden, el cargo se reembolsa automáticamente a tu saldo interno — no necesitas hacer ningún seguimiento manual.

Todavía no — cada orden usa tu saldo interno real en TRX. Empieza con el volumen más pequeño (1.000 Bandwidth, 15 minutos) para probar el flujo completo con el menor costo posible.

La respuesta llega de inmediato con estado "Created". Registra un webhook para order.filled (o consulta la orden) para saber exactamente cuándo se completa la delegación — normalmente unos 0,3s después.