错误码

失败会返回 HTTP 错误状态和一个稳定的信封结构：

{
  "error": {
    "code": "INVALID_DURATION",
    "message": "Unsupported duration",
    "details": null
  },
  "request_id": "…"
}

code 稳定且适合匹配；message 是人类可读的，可能会变化。

错误码	HTTP	含义
`UNAUTHORIZED`	401	签名头缺失或无效、签名错误、时间戳过期、nonce 被重放，或 API key 未知/已吊销。
`FORBIDDEN`	403	已认证但无权限。
`INVALID_REQUEST`	400	请求格式错误或校验失败。
`INVALID_ADDRESS`	400	`target_address` 不是有效的 TRON 地址。
`INVALID_DURATION`	400	`duration_minutes` 不在允许的目录中。
`NOT_FOUND`	404	资源不存在。
`ORDER_NOT_FOUND`	404	报价或订单不存在，或不属于你的账户。
`QUOTE_EXPIRED`	409	报价已不再可用或已过期。
`INSUFFICIENT_BALANCE`	402	预付余额不足以支付订单。
`IDEMPOTENCY_CONFLICT`	409	幂等键被不同载荷复用。
`RATE_LIMITED`	429	请求过于频繁；请降速后重试。
`SERVICE_UNAVAILABLE`	503	服务不可用；请稍后重试。
`INTERNAL_ERROR`	500	未预期的服务器错误。

重试建议