Skip to content

错误码

所有接口在发生异常时都会返回统一格式的错误信息,HTTP 状态码会配合下列错误码一起使用。

错误响应示例

json
{
    "code": -1121,
    "msg": "Invalid symbol."
}

HTTP 状态码

状态码描述
4XX错误的请求内容、行为、格式
429访问频次超限,即将被封 IP
418收到 429 后继续访问,IP 已被封禁
5XX服务器内部错误;不要 把它当成一个失败的任务,因为执行状态未知,有可能成功也有可能失败
504API 服务端已经向业务核心提交了请求但未能获取响应,不代表 请求失败,而是未知;很可能已经得到了执行,也有可能执行失败,需要做进一步确认

通用错误码

错误码描述
-1000未知错误
-1001服务不可用
-1002未授权操作
-1003请求频率超限
-1017请求头 Content-Type 不合法
-1021时间戳超出允许的 recvWindow 范围
-1022签名无效
-1100非法参数
-1101缺少必填参数
-1102参数类型错误
-1121无效的币对 / 合约名称

交易相关错误码

错误码描述
-2010下单失败
-2011撤单失败
-2013订单不存在
-2014API-key 格式错误
-2015API-key 无效、或签名错误