POST

一键下单

/api/v1/energy/orders

单次调用创建订单。价格在下单时实时解析，并立即从你的预付余额中冻结资金；履约异步进行。

如果你需要在下单前锁定价格，请改用两步流程：创建报价，然后凭报价下单。

请求体

字段	类型	必填	说明
`amount`	integer	是	要代理的资源数量——能量或带宽（≥ 1）。
`duration_minutes`	integer	是	租用时长；必须是允许的时长之一。
`target_address`	string	是	要代理到的 TRON 地址。
`product`	string	否	`TRON_ENERGY`（默认）或 `TRON_BANDWIDTH`。
`idempotency_key`	string	是	你为安全重试生成的唯一 key（≤ 200 字符）。

{
  "product": "TRON_ENERGY",
  "amount": 64400,
  "duration_minutes": 60,
  "target_address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "idempotency_key": "idem-0001"
}

响应

{
  "data": {
    "order_id": "ord_9c2b7f0a",
    "status": "PENDING",
    "product": "TRON_ENERGY",
    "amount": 64400,
    "duration_minutes": 60,
    "target_address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
    "customer_price": "2.093",
    "currency": "TRX",
    "created_at": "2026-09-22T12:00:00.000Z",
    "completed_at": null,
    "failure_reason": null
  },
  "request_id": "…"
}

字段	类型	说明
`order_id`	string	订单 id。
`status`	string	`PENDING`、`COMPLETED`、`FAILED` 或 `RECONCILIATION_REQUIRED`。
`customer_price`	string	订单价格，单位 TRX（十进制字符串，非 SUN；1 TRX = 10^6 SUN）。
`currency`	string	始终为 `TRX`。

错误

INVALID_ADDRESS —— target_address 不是有效的 TRON 地址。
INVALID_DURATION —— duration_minutes 不在允许的目录中。
INVALID_REQUEST —— product 未知，或 amount 超出支持范围。
INSUFFICIENT_BALANCE —— 预付余额不足以支付该订单。
IDEMPOTENCY_CONFLICT —— 幂等键被不同载荷复用。