购买能量或带宽
POST/buy
为接收地址租用 1 小时的能量（默认）或带宽；通过 resource_type 选择。费用会立即从你的账户余额中扣除——当接收地址尚未在 TRON 上激活时，还包括一次性账户激活费（activation_fee_sun）。订单以 PENDING 开始；资源通常在几秒内完成委托。使用 查询订单 端点轮询完成状态。
receiver_address 在任何扣款之前校验：无效地址返回 400 invalid_address。
请发送 Idempotency-Key 请求头，这样超时后的重试会返回原订单，而不会再下一单——见幂等性。
请求
Responses
- 201
- 400
- 401
- 403
- 409
- 422
- 429
- 500
- 503
成功响应
购买被拒绝；未扣取任何费用：
insufficient_balance——你的余额低于订单总额（无message；带有以 SUN 计的current_balance和required_amount）order_amount_below_minimum/order_amount_above_maximum——以code为键，带min/maxinvalid_address——receiver_address不是有效的 TRON 地址invalid_idempotency_key——Idempotency-Key超过 128 个字符unsupported_resource——仅提供能量或带宽；只能购买能量的账户下的带宽订单也会被拒绝
X-API-Key 请求头缺失、无效或已撤销。detail 为纯字符串：API key required、Invalid API key 或 User not found。
账户已被封禁（纯字符串 detail：Account is blocked），或 ip_not_allowed——请求的来源 IP 不在该密钥的 IP 白名单内。或 reseller_suspended（无 message）——你的账户已被暂停购买；请联系客服。
duplicate_request——具有相同 Idempotency-Key 的请求仍在处理中。几秒后用同一密钥重试。如果一直返回 409，请先查看 GET /orders，再用新密钥重试。
请求体校验失败（例如缺少字段、resource_amount 不大于 0，或 duration 不是 1h）——detail 为字段错误数组。
Rate limit exceeded——你的账户每分钟请求超过 1,000 次（由该账户的所有 API 密钥与工作台会话共用）。detail 为纯字符串；等待 Retry-After 给出的秒数后再重试。
Response Headers
距离限流窗口重置的秒数。
internal_error——意外错误；订单未创建。请稍后重试。
service_unavailable——所请求资源的购买暂时不可用；或 reseller_activation_balance_low（无 message）——你的账户暂时无法购买。请稍后重试。