跳到主要内容
版本：Next (V2.0)

通用响应格式

现货 Open API 响应格式​

成功响应（code = 0）：

{
  "code": 0,
  "msg": "success",
  "data": { ... }
}

合约 Open API 响应格式​

成功响应（code = 0）：

{
  "code": 0,
  "msg": "success",
  "data": { ... }
}

错误响应（通用）​

{
  "code": 400,
  "message": "错误描述"
}

合约 HTTP 错误码​

HTTP status 与 body code 相同。

错误码说明
400参数错误 / 请求体读取失败
401缺少鉴权参数 / 时间戳过期 / 签名验证失败 / 无效的 API Key
403IP 不在白名单 / 该 API Key 无交易权限
429请求频率超限（每秒/每分钟）/ 下单频率超限
500内部错误

合约业务错误码（HTTP 200）​

业务错误以 HTTP 200 返回，通过 body 中的 code 字段区分。

错误码说明
0成功
1001系统错误
3000交易对不存在 / 对象不存在
3004第三方服务错误（K 线 / Ticker 查询失败等）
8001低于最小交易量
8002平仓委托失败，请检查持仓
8003平仓余额不足，请检查持仓与挂单
8004委托订单创建失败
8005止盈止损订单创建失败
8006止盈止损订单将被立即触发
8007调整杠杆需要更多起始保证金
8008调整杠杆失败
8009切换保证金模式失败
8010有持仓，不支持调整保证金模式
8011杠杆异常
8012保证金模式异常
8013追加保证金失败
8014逐仓模式下有持仓，不支持调低杠杆
8015可减少保证金不足
8016超过最大交易量
8017超过最大持仓量
8018保证金不足
8100产品信息异常

现货 HTTP 错误码​

现货 API 无业务错误码，所有错误均以对应 HTTP 状态码返回，具体原因在 msg 字段中。

错误码说明
400参数错误 / 交易对不存在 / 下单撤单失败（余额不足等业务错误，具体原因见 msg）
401缺少鉴权参数 / 时间戳过期 / 签名验证失败 / 无效的 API Key
403IP 不在白名单 / 无交易权限
404订单不存在
429请求频率超限 / 下单频率超限
500内部错误 / K 线服务不可用