错误码
响应结构与错误码说明。
所有响应使用统一结构:code(0 表示成功)、msg、data。错误同时保留有语义的 HTTP 状态码。
错误示例
{
"code": 40000,
"msg": "no receiving address configured for chain \"base\"; set it in the Boss console first"
}| code | HTTP | 含义 |
|---|---|---|
| 0 | 200 | 成功 |
| 40000 | 400 | 校验失败——链/资产不支持、地址格式错误、金额超限、未配置收款地址等 |
| 40100 | 401 | 凭证缺失或无效(JWT、API Key 或 Privy token) |
| 40300 | 403 | 已认证但无权限 |
| 40400 | 404 | 订单或资源不存在(或属于其他账户) |
| 42900 | 429 | 触发限流——请降低频率 |
| 50000 | 500 | 内部错误——可携带相同 external_id 安全重试 |
- 报价失败会以 400 返回,msg 中包含上游原因(例如金额低于该路径最小值)。
- 订单创建按 external_id 幂等——重试不会重复扣款。