错误码
所有接口在发生异常时都会返回统一格式的错误信息,HTTP 状态码会配合下列错误码一起使用。
错误响应示例
json
{
"code": -1121,
"msg": "Invalid symbol."
}HTTP 状态码
| 状态码 | 描述 |
|---|---|
4XX | 错误的请求内容、行为、格式 |
429 | 访问频次超限,即将被封 IP |
418 | 收到 429 后继续访问,IP 已被封禁 |
5XX | 服务器内部错误;不要 把它当成一个失败的任务,因为执行状态未知,有可能成功也有可能失败 |
504 | API 服务端已经向业务核心提交了请求但未能获取响应,不代表 请求失败,而是未知;很可能已经得到了执行,也有可能执行失败,需要做进一步确认 |
通用错误码
| 错误码 | 描述 |
|---|---|
-1000 | 未知错误 |
-1001 | 服务不可用 |
-1002 | 未授权操作 |
-1003 | 请求频率超限 |
-1017 | 请求头 Content-Type 不合法 |
-1021 | 时间戳超出允许的 recvWindow 范围 |
-1022 | 签名无效 |
-1100 | 非法参数 |
-1101 | 缺少必填参数 |
-1102 | 参数类型错误 |
-1121 | 无效的币对 / 合约名称 |
交易相关错误码
| 错误码 | 描述 |
|---|---|
-2010 | 下单失败 |
-2011 | 撤单失败 |
-2013 | 订单不存在 |
-2014 | API-key 格式错误 |
-2015 | API-key 无效、或签名错误 |