POST

速充下单

/api/v1/energy/flash_orders

创建速充订单（能量或带宽）。与租用订单不同，速充订单没有时长：它为目标地址充值资源缓冲，实际金额根据真实用量异步结算。下单时会先冻结一个估算金额，订单结算时把剩余部分退还。

速充订单支持能量和带宽，适合持续需要能量的账户。它们会在你的订单历史中以 order_type: "FLASH" 区分。

下单前想先看价格和冻结金额，可使用速充估价。

限制

energy_num 必须在对应产品的取值范围内：
1. 速冲能量：100000 到 500000000。
2. 速冲带宽：50000 到 1000000。
特定目标地址的实际可下单范围取决于当前可用情况。下单前请查询 POST /api/v1/energy/flash_limits 获取实时最小/最大值。

可下单范围（flash_limits） — POST /api/v1/energy/flash_limits 返回目标地址当前可下单范围。它接收 product（TRON_ENERGY，默认；或 TRON_BANDWIDTH）和 target_address。
{
  "product": "TRON_BANDWIDTH",
  "target_address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE"
}
{
  "data": {
    "product": "TRON_BANDWIDTH",
    "target_address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
    "enabled": true,
    "min_quantity": 50000,
    "max_quantity": 1000000
  },
  "request_id": "…"
}
enabled: false 表示该产品当前对该地址不可用。

min_quantity / max_quantity 在当前范围未知时会省略。

请求体

字段	类型	必填	说明
`energy_num`	integer	是	要充值的资源缓冲（1 ≤ energy_num ≤ 500000000）。`TRON_ENERGY` 为能量单位，`TRON_BANDWIDTH` 为带宽单位。
`target_address`	string	是	要充值的 TRON 地址。
`product`	string	否	`TRON_ENERGY`（默认）或 `TRON_BANDWIDTH`。带宽速充目前仅对已开通的账户可用。
`idempotency_key`	string	是	你为安全重试生成的唯一 key（≤ 200 字符）。

{
  "product": "TRON_ENERGY",
  "energy_num": 200000,
  "target_address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "idempotency_key": "idem-0001"
}

响应

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

字段	类型	说明
`order_id`	string	订单 id。
`order_type`	string	速充订单为 `FLASH`（租用订单为 `RENTAL`）。
`status`	string	`PENDING`、`COMPLETED`、`FAILED` 或 `RECONCILIATION_REQUIRED`。
`customer_price`	string	下单时的估算价；订单完成后会被覆盖为实际结算价。单位 TRX（十进制字符串，非 SUN；1 TRX = 10^6 SUN）。
`duration_minutes`	null	速充订单没有时长。

结算语义

下单时会冻结估算价加上一定安全边际（不是价格承诺）。
我们为目标地址进行能量代理，之后回收未用能量并按实际用量结算。
完成后按实际结算金额扣款，冻结的剩余部分退回可用余额。
轮询速充订单（或订阅 Webhooks）以观察 COMPLETED/FAILED。

错误

INVALID_ADDRESS — target_address 不是有效的 TRON 地址。
INVALID_REQUEST — product 不是 TRON_ENERGY 或 TRON_BANDWIDTH，带宽速充未对你的账户开通，或 energy_num 超出支持范围。
INSUFFICIENT_BALANCE — 你的预付余额无法覆盖冻结的估算金额。
IDEMPOTENCY_CONFLICT — 幂等 key 被用于不同的请求载荷。