通过 API 购买 TRON 带宽
查看文档 →带宽是 TRON 网络为不涉及智能合约存储的普通转账和合约调用收取的资源 —— 最常见的场景是普通的 TRX 转账。只需调用一个接口，传入目标地址和数量，我们就会直接将带宽委托给该地址。
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())请求格式
请求体
resourcestring"energy" 或 "bandwidth"，省略时默认为 energy。
targetAddressstring接收被委托资源的 TRON 地址。
volumeinteger要委托的数量。带宽：1,000–300,000；能量：65,000–1,000,000。
durationstring"15m"、"1h" 或 "1d"。
请求头
X-Api-Key你的 API key。
Idempotency-Key由你生成的 UUID。使用相同的键重试将返回原始订单，而不会重复扣费。
响应体
id订单 ID。
status初始为 "Created"，委托完成后变为 "Filled"（或 "Failed"）。订阅 order.filled Webhook 即可获知资源到账的确切时刻。
priceTrx / activationTrx / totalTrx以 TRX 计的费用。仅当目标地址首次接收 TRX 时，activationTrx 才会非零。
txId委托交易的哈希，订单完成后才会填充。
从零开始发起第一次请求
01
注册账户
创建一个免费的 TronGasAi 账户。
02
获取 API key
在控制台中生成一个具有指定权限范围的密钥。
03
发送测试请求
使用你的密钥调用 POST /orders。
04
接入你的项目
将同样的调用集成到你的应用或服务中。
常见问题
一笔普通的 TRX 转账大约需要 267 带宽。其他类型的转账可能需要略多一些 —— 我们 1,000 的最低起购量足以覆盖多笔转账并留有余量。
订单会在扣费前被拒绝（402，wallet.insufficient_balance）—— 请充值你的内部 TRX 余额，然后使用相同的 Idempotency-Key 重试。
如果供应商无法完成订单，费用会自动退回到你的内部余额 —— 无需手动跟进。
目前还没有 —— 每笔订单都使用你真实的内部 TRX 余额。建议先从最小数量（1,000 带宽，15 分钟）开始，以最低成本完整体验整个流程。
响应会立即返回 "Created" 状态。注册 order.filled Webhook（或轮询订单状态）即可准确获知委托完成的时刻 —— 通常在约 0.3 秒后。