TRON 能量 API 适合谁?
适合所有通过代码在 TRON 上发送 USDT,且发送频繁到每笔转账燃烧 6.50 TRX 会累积成可观成本的用户。
在每批提币之前为热钱包租赁能量。
每笔出款对应一次幂等租赁,以您的出款 ID 作为键。
使用 x402 完全无需账户:报价、以 USDC 支付、轮询状态。
账户 API 还是 x402:该用哪个?
| 账户 API | x402 | |
|---|---|---|
| 注册 | 带 API 密钥的账户 | 无需:没有账户,没有 API 密钥 |
| 支付方式 | 预充值的 TRX 余额 | Base(首选)或 Solana 上的 USDC,按次支付 |
| 价格锁定 | 直到报价的 valid_until | 10 分钟,锁定能量价格和 TRX/USD 汇率 |
| 跟踪 | GET /v1/operations/{id} | 报价中的 status_url |
| 最适合 | 稳定的业务量,统一结算 | 智能体、一次性脚本、不保留余额 |
如何使用账户 API 租赁 TRON 能量
- 创建 API 密钥
使用 Telegram 或 Google 登录,打开 API 并创建密钥。完整密钥只显示一次。请以
Authorization: Bearer <key>的形式发送。 - 锁定价格
调用
POST /v1/quotes/energy,传入energy_amount、duration_seconds(3600 或 86400)以及将要发送 USDT 的target_address。响应包含quote_id、price_trx、valid_until,以及相对于燃烧 TRX 的预计节省金额。 - 使用报价租赁
调用
POST /v1/rental,传入quote_id并附带Idempotency-Key请求头。系统会从您的余额中预留资金,并将租赁加入队列;响应为202,并在Location中给出该操作的地址。 - 等待到账,然后发送 USDT
轮询该操作直到成功,然后从目标地址签署转账。
/v1/quotes/energy锁定价格/v1/rental租赁能量/v1/operations/{id}跟踪到账自定义数量如需 65,000 或 130,000 以外的数量,请将 custom_amount 设为 true。当前最低数量由 API 公布;参考文档说明了在哪里读取。
无需密钥即可读取 TRON 能量价格
GET https://tronenergyfrog.com/api/v1/rates/energy/default 返回 65,000 能量 1 小时的公开价格、同等能量需燃烧的 TRX、节省金额以及每小时历史数据。可添加 ?history=1d、7d、30d 或 90d。响应缓存 30 秒。
{
"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": [ … ]
}
}可用于数据看板和价格提醒。下单时请务必请求报价:公开费率只是参考,不是锁定价格。
x402:以 USDC 租赁 TRON 能量,无需账户
无需注册、账户、API 密钥或预充值余额。通过 GET /v1/x402 获取当前接口约定,然后按照标准 x402 流程操作。字段级结构请见 API 参考文档的 x402 部分。
- 读取能力接口
GET /v1/x402列出当前的接口和支持的支付网络。 - 创建免费报价
调用
POST /v1/x402/quotes,传入target_address(可选energy_amount、duration_seconds)。它会锁定能量价格和 TRX/USD 换算十分钟。 - 获取支付质询
不带签名,对返回的
payment_url发送一次 POST 请求。响应为402 Payment Required,并附带PAYMENT-REQUIRED。 - 支付并重试
从智能体的钱包中按公布的任一选项支付,然后带上
PAYMENT-SIGNATURE重试同一 URL。结算成功后会返回PAYMENT-RESPONSE。 - 轮询状态 URL
status_url同时报告支付结算和能量到账情况。
| 优先级 | 资产 | 网络 | 用途 |
|---|---|---|---|
| 首选 | USDC | Base | 兼容智能体的首选 |
| 备选 | USDC | Solana | 智能体的资金在 Solana 上时 |
以 402 响应为准网络标识、代币地址、收款方、过期时间和精确的原子单位金额均以 402 响应为准。机器人应读取 API 响应,而不是抓取本页面获取价格。
如何确认能量已到账?
每次租赁都是一个操作。轮询 GET /v1/operations/{id},直到它进入最终状态;成功的操作会附带代理交易的 txid,您可以在 TronScan 上打开查看。
| 状态 | 应该怎么做 |
|---|---|
| queued processing submitted | 继续轮询。暂时不要发送 USDT。 |
| succeeded | 能量已在目标地址上。请在租期内发送转账。 |
| failed | 读取 error_code。不要在假定能量已到账的情况下发送 USDT。 |
| unknown | 结果尚未确认。继续轮询;处理方式请见参考文档。 |
历史接口,以及用于将操作与您自己的订单对应的项目 ID,请参阅 API 参考文档。