# 波场能量租赁 API 接入指南：签名、下单与回调

TRONow 波场能量 API 接入指南：最低 65K，实时报价、幂等下单、五种订单状态与 Webhook 验签。附公开 OpenAPI 规范及 Node.js 客户端。

Canonical: https://tronow.io/zh-CN/guides/tron-energy-api/
Reviewed by TRONow · 2026-10-03

## 钱包直购和商户余额有什么区别

注册商户账户后，在商户后台「充值」查看专属 TRON 主网地址。只支持原生 TRX，每笔至少 10 TRX，低于此金额不入账。累计入账达到 20 TRX 后，API 与商户后台购买同时解锁。充值只增加余额，不会自动生成能量订单；每笔订单仍需有足够的可用余额。

## 最低 65K，先为准确数量获取报价

最低下单量为 65,000 Energy（65K）。API 报价和下单的 resource_amount 均须为不小于 65000 的整数，自定义数量同样适用。32K、64K 等低于最低数量的请求返回 422 UNSUPPORTED_PRODUCT，请修改数量后再请求。按照准确的资源类型、数量和租期获取实时报价。响应会返回 price_sun、currency 和 priced_at；price_sun 是整数 SUN 字符串，用于展示当前参考价，请勿写死价格。POST /orders 受理时会重新计算并锁定该笔订单价格，不需要提交报价编号。

## 一个业务订单，只创建一次

创建订单时提交资源类型、数量、租期、接收钱包和自己的 client_order_id。同一业务请求使用同一个 Idempotency-Key。受理响应会返回平台订单号和已锁定的冻结金额；响应超时后，应使用原始参数和原始幂等键重试，或查询订单，不要仅因响应丢失就换新键再次购买。

## 能量订单的五种状态如何判断

HTTP 受理成功不代表能量已可用。请查询订单或处理验签后的 Webhook。CONFIRMING 已有哈希，可在 TRONSCAN 查看；稳妥起见，等待 SUCCESS 或确认钱包可用能量后再转账。SUCCESS 表示已在 TRON 查到该哈希，不代表之后的 USDT 转账已经成功。结果不确定时，不要重复创建订单。

| API 状态 | 含义 | 资金处理 |
| --- | --- | --- |
| PROCESSING | 正在处理，尚无交易哈希。 | 冻结中 |
| CONFIRMING | 已获得哈希，正在异步查询链上交易。 | 冻结中 |
| SUCCESS | 已在 TRON 查到该哈希。 | 按锁定订单金额扣款 |
| FAILED | 订单处理失败并结束。 | 已释放冻结金额 |
| REVIEWING | 结果尚不确定，需要人工核查。 | 继续冻结，等待处理 |

## 保护凭证与回调

API Secret 保存在自己的服务器端，配置允许访问的来源 IP，并校验 Webhook 签名。日志保留必要的订单标识和排查信息，不记录完整凭证。回调可能重复投递，消费方需要按事件实现幂等处理。

## 按实际账户报价评估价格

官网展示的是标准 API 参考价，不代表所有账户拥有相同产品和价格。您的账户实时报价才是成交依据。先用受支持的数量验证完整订单生命周期，再逐步扩大业务，并观察余额、失败订单和回调处理情况。

## 资料中心

- [波场能量租赁教程：TRON 能量与 USDT 转账费用](https://tronow.io/zh-CN/guides/tron-energy-usdt/)
- [关于 TRONow：波场能量租赁与商户 API](https://tronow.io/zh-CN/about/)
- [波场能量租赁价格 - 65K / 131K 实时报价](https://tronow.io/zh-CN/pricing/)
- [TRONow 常见问题：购买能量、充值与 API 接入](https://tronow.io/zh-CN/faq/)
- [可靠接入波场能量 API：幂等、回调与订单对账](https://tronow.io/zh-CN/guides/reliable-energy-integration/)
- [USDT 转账选 65,000 还是 131,000 能量？](https://tronow.io/zh-CN/guides/usdt-energy-65000-131000/)
- [租了波场能量，转 USDT 为什么还扣 TRX？](https://tronow.io/zh-CN/guides/usdt-transfer-troubleshooting/)
- [TRON USDT 转账能量档位参考](https://tronow.io/zh-CN/tools/usdt-fee-calculator/)

## 开发者接入资料

- [OpenAPI](https://tronow.io/developers/openapi.yaml)
- [Skill: authentication, idempotency, webhook verification](https://tronow.io/developers/tronow-connect/SKILL.md)
- [Node.js](https://tronow.io/developers/tronow-connect/client.mjs)
- [错误码与处理](https://tronow.io/developers/errors.zh-CN.md)