</> 批量 API

TRON Energy 批量 API

适用于交易平台、OTC、支付系统和机器人:一次认证请求最多提交 50 个 Energy 订单。

{ }
POST/api/v1/orders/bulk/
{
  "orders": [
    {"external_id":"bulk-001","package_id":1,"duration_minutes":15,"address":"T..."},
    {"external_id":"bulk-002","energy_amount":65000,"duration_minutes":60,"address":"T..."}
  ]
}

单次最多 50 个项目。需要 orders:create 权限。每个项目都会返回 accepted 或 failed。

幂等性

每个订单请使用唯一 external_id。重复使用同一 ID 不会创建重复订单。

Webhook

批量订单创建后会成为普通 TRONENS 订单,并使用现有状态和 webhook 系统。

部分结果

如果部分项目验证失败,API 会返回每个订单的结果,并保留成功的项目。