Rentron开发者文档
API 工作区https://api.rentron.xyz/v1快速请求
POST /v1/energy/quotes
curl https://api.rentron.xyz/v1/energy/quotes \
-X POST \
-H "Authorization: HMAC-SHA256 {api_key}:{base64_signature}" \
-H "X-Request-Timestamp: 1784376000" \
-H "Content-Type: application/json" \
-d '{
"address": "TXYZ",
"energy": 65000,
"duration_hours": 1
}'200 OK
{ "total_trx": "3.200000", "can_afford": true }端点地图
API 基础
04/v1/time 在签名请求前读取 API Unix 时间，并诊断本地时钟偏差。
/v1/balance 创建订单前读取可用和已预留的 TRX。
/v1/energy/options 读取可用的 Energy 数量、租赁时长和当前是否接收新订单。
/v1/energy/quotes 不改变账户余额，计算某个 TRON 地址当前的 Energy 租赁价格。
Energy 订单
03/v1/energy/orders 创建幂等的 Energy 租赁订单，并获取固定金额和轮询 URL。
/v1/energy/orders/{id} 读取一笔属于该账户的订单，并判断资源分配和完整租赁生命周期是否结束。
/v1/energy/orders?limit=20&cursor=... 使用不透明游标分页，按从新到旧的顺序读取订单。
概览
Rentron Energy API 让服务器无需在控制台手动操作即可租用 TRON Energy。集成使用标准 HTTPS 请求、HMAC 身份验证和订单状态轮询。
一分钟概览
| 设置 | 值 |
|---|---|
| 基础 URL | https://api.rentron.xyz/v1 |
| 格式 | 使用 snake_case 字段的 JSON |
| 身份验证 | 除 GET /v1/time 外均为 HMAC-SHA256 |
| 订单更新 | 仅轮询；没有 webhook 或 callback |
| 错误 | RFC 9457，application/problem+json |
| OpenAPI | https://rentron.xyz/openapi/rentron-energy-v1.json |
API 使用生产环境账户余额，没有独立的 sandbox API。
下单流程
- 读取当前租赁选项并获取报价。
- 使用唯一
client_request_id，并将报价中的精确total_trx作为expected_total_trx提交。 - 保存返回的
id和Location请求头。 - 轮询
GET /v1/energy/orders/{id}，直到lifecycle_final和delivery_final都为true。
合约保证
- 服务器会在创建订单时固定最终金额，并以
total_trx返回。 - 金额均为恰好六位小数的字符串。
- 用相同
client_request_id重放完全相同的请求，不会创建重复订单。 - 不存在的订单 ID 和其他账户的订单 ID 均返回相同的
404。 - 应用逻辑应使用稳定错误
code，绝不能解析detail。