POST

凭报价下单

/api/v1/energy/apply_quote_orders

凭此前创建的报价创建订单。这是两步流程：创建报价以锁定价格，然后在此处应用该报价。资金从你的预付余额冻结，履约异步进行。

如果你不需要先锁定价格，请改用一键下单接口。

请求体

字段	类型	必填	说明
`quote_id`	string	是	你创建的报价的 id。
`target_address`	string	是	必须与报价中的目标地址一致。
`idempotency_key`	string	是	你为安全重试生成的唯一 key（≤ 200 字符）。

{
  "quote_id": "qte_1a2b3c4d5e6f7g8h",
  "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`。

错误

ORDER_NOT_FOUND —— 报价 id 不存在或不属于你。
QUOTE_EXPIRED —— 报价已不再可用或已过期。
INVALID_REQUEST —— 目标地址与报价不匹配。
INSUFFICIENT_BALANCE —— 预付余额不足以支付该订单。
IDEMPOTENCY_CONFLICT —— 幂等键被不同载荷复用。