本页面也提供英文版。
TronEnergyFrog

开发者 · REST 与 x402

TRON 能量租赁 API

三个调用即可从您的后端租赁能量:POST /v1/quotes/energy 锁定价格,POST /v1/rental 完成租赁,GET /v1/operations/{id} 确认到账。公开费率无需密钥。没有账户的机器人和 AI 智能体可以通过 x402 以 USDC 按次支付租赁费用。

本页内容
  1. 适用对象
  2. 账户 API 还是 x402
  3. 使用账户 API 租赁
  4. 公开费率,无需密钥
  5. x402:以 USDC 支付
  6. 跟踪到账
  7. API 常见问题
# 1. 锁定 65,000 能量 1 小时的价格
curl -X POST https://api.tronenergyfrog.com/v1/quotes/energy \
  -H "Authorization: Bearer $TEF_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"energy_amount":65000,"duration_seconds":3600,
       "target_address":"TQ5nW3…8k2Wd"}'
# → { "quote_id": "1111…", "price_trx": "…", … }

# 2. 完成租赁。使用相同的密钥重试,绝不会重复租赁。
curl -X POST https://api.tronenergyfrog.com/v1/rental \
  -H "Authorization: Bearer $TEF_API_KEY" \
  -H "Idempotency-Key: payout-2026-0042" \
  -H "Content-Type: application/json" \
  -d '{"quote_id":"1111…"}'
# → 202 Accepted · Location: /v1/operations/3333…

# 3. 跟踪到账
curl https://api.tronenergyfrog.com/v1/operations/3333… \
  -H "Authorization: Bearer $TEF_API_KEY"
# → { "status": "succeeded", "txid": "…" }
精简示例;地址和 ID 均为占位符。完整结构请见参考文档
租赁能量所需调用
3报价、租赁、跟踪
今日 65K 能量 1 小时
1.55 TRX≈ US$0.47,对比燃烧 6.50 TRX
x402 所需账户
0以 USDC 按次支付租赁费用
x402 报价锁定价格时长
10 分钟能量价格与 TRX/USD 汇率

TRON 能量 API 适合谁?

适合所有通过代码在 TRON 上发送 USDT,且发送频繁到每笔转账燃烧 6.50 TRX 会累积成可观成本的用户。

交易所和钱包

在每批提币之前为热钱包租赁能量。

出款和支付系统

每笔出款对应一次幂等租赁,以您的出款 ID 作为键。

机器人和 AI 智能体

使用 x402 完全无需账户:报价、以 USDC 支付、轮询状态。

账户 API 还是 x402:该用哪个?

账户 APIx402
注册带 API 密钥的账户无需:没有账户,没有 API 密钥
支付方式预充值的 TRX 余额Base(首选)或 Solana 上的 USDC,按次支付
价格锁定直到报价的 valid_until10 分钟,锁定能量价格和 TRX/USD 汇率
跟踪GET /v1/operations/{id}报价中的 status_url
最适合稳定的业务量,统一结算智能体、一次性脚本、不保留余额

如何使用账户 API 租赁 TRON 能量

  1. 创建 API 密钥

    使用 Telegram 或 Google 登录,打开 API 并创建密钥。完整密钥只显示一次。请以 Authorization: Bearer <key> 的形式发送。

  2. 锁定价格

    调用 POST /v1/quotes/energy,传入 energy_amount、duration_seconds(3600 或 86400)以及将要发送 USDT 的 target_address。响应包含 quote_id、price_trx、valid_until,以及相对于燃烧 TRX 的预计节省金额。

  3. 使用报价租赁

    调用 POST /v1/rental,传入 quote_id 并附带 Idempotency-Key 请求头。系统会从您的余额中预留资金,并将租赁加入队列;响应为 202,并在 Location 中给出该操作的地址。

  4. 等待到账,然后发送 USDT

    轮询该操作直到成功,然后从目标地址签署转账。

POST/v1/quotes/energy锁定价格
POST/v1/rental租赁能量
GET/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 秒。

响应示例 · 示意数值 · average_commission_trx = 没有能量时燃烧的 TRX
{
  "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 部分。

  1. 读取能力接口

    GET /v1/x402 列出当前的接口和支持的支付网络。

  2. 创建免费报价

    调用 POST /v1/x402/quotes,传入 target_address(可选 energy_amount、duration_seconds)。它会锁定能量价格和 TRX/USD 换算十分钟。

  3. 获取支付质询

    不带签名,对返回的 payment_url 发送一次 POST 请求。响应为 402 Payment Required,并附带 PAYMENT-REQUIRED。

  4. 支付并重试

    从智能体的钱包中按公布的任一选项支付,然后带上 PAYMENT-SIGNATURE 重试同一 URL。结算成功后会返回 PAYMENT-RESPONSE。

  5. 轮询状态 URL

    status_url 同时报告支付结算和能量到账情况。

优先级资产网络用途
首选USDCBase兼容智能体的首选
备选USDCSolana智能体的资金在 Solana 上时

以 402 响应为准网络标识、代币地址、收款方、过期时间和精确的原子单位金额均以 402 响应为准。机器人应读取 API 响应,而不是抓取本页面获取价格。

如何确认能量已到账?

每次租赁都是一个操作。轮询 GET /v1/operations/{id},直到它进入最终状态;成功的操作会附带代理交易的 txid,您可以在 TronScan 上打开查看。

状态应该怎么做
queued processing submitted继续轮询。暂时不要发送 USDT。
succeeded能量已在目标地址上。请在租期内发送转账。
failed读取 error_code。不要在假定能量已到账的情况下发送 USDT。
unknown结果尚未确认。继续轮询;处理方式请见参考文档。

历史接口,以及用于将操作与您自己的订单对应的项目 ID,请参阅 API 参考文档。

API 常见问题

仍有疑问?联系客服,由真人为您解答。

使用 TRON 能量 API 需要账户吗?

使用账户 API 需要:请在您的账户中创建 API 密钥。公开费率接口和 x402 接口无需账户或 API 密钥。

API 租赁如何付款?

账户 API 的租赁从您预充值的账户余额中支付。x402 租赁以 USDC 按次支付,可使用 Base(首选)或 Solana。

请求重试时如何避免重复付款?

调用 POST /v1/rental 时发送 Idempotency-Key 请求头。使用相同的键重复请求不会创建第二次租赁。

机器人应该选择哪种 x402 支付选项?

可用时选择 Base 上的 USDC,备选为 Solana 上的 USDC。网络、代币地址、收款方、过期时间和精确金额均以 402 响应为准。

完整的请求和响应结构在哪里?

在 API 参考文档中,也提供 OpenAPI JSON 和 Markdown 版本。

关于本页

接口和字段名称与已发布的 API 参考文档一致。代码为便于阅读已作精简;完整的结构和错误说明请见参考文档。

参考文档
api.tronenergyfrog.com/v1/docs其中链接了 OpenAPI JSON 和 Markdown 版本
价格
公开费率 API,2026年11月22日 12:28 UTC
x402
x402 支付流程,Base 和 Solana 上的 USDC
审核
2026 年 11 月 17 日 · TronEnergyFrog 团队

下一份 65K 只需 1.55 TRX,而不是燃烧 6.50 TRX

先在网站上试一次租赁,再将其自动化。访客租赁无需账户,付款前不收取任何费用。

您的下一笔转账

所需能量
65,000
没有能量时
燃烧 6.50 TRX ≈ US$1.98
使用 TronEnergyFrog
1.55 TRX ≈ US$0.47
您可节省
4.95 TRX ≈ US$1.51
65K 能量,1 小时1.55 TRX ≈ US$0.47
租赁能量