Skip to main content
本文档面向 API 用户,说明接口返回的错误码含义及处理建议。

响应格式

HTTP API

WebSocket


错误码速查表


详细说明

认证错误 (1xxx)

1001 - API Key 无效或已过期

原因
  • API Key 输入错误
  • API Key 已被禁用
  • API Key 已过期
解决:检查 API Key 是否正确,或联系管理员确认状态。

1002 - 未提供 API Key

解决:在 HTTP 请求头中添加 X-API-Key: your_api_key,或在 WebSocket URL 中添加 ?api_key=your_api_key

1003 - IP 不在白名单

原因:企业版套餐启用了 IP 白名单限制。 解决:联系管理员将您的 IP 添加到白名单。

1004 - 权限不足

原因:当前套餐不支持该功能。 解决:升级套餐或联系管理员。

参数错误 (2xxx)

2001 - 参数错误

解决:检查请求参数是否完整、格式是否正确。

2002 - 交易品种不存在

解决:调用 GET /v1/symbols/available 获取可用品种列表。

2003 - 时间范围无效

原因
  • start_time 大于 end_time
  • 时间格式错误
  • 时间范围超出限制
解决:使用 Unix 毫秒时间戳,确保 start_time < end_time。

2004 - 请求数量超限

解决:减少 limit 参数值(通常最大 1000)。

限流错误 (3xxx)

3001 - 请求频率超限

HTTP 响应会包含 Retry-After 头,指示等待秒数。 解决
  • 降低请求频率
  • 使用 WebSocket 订阅替代轮询
  • 升级套餐获取更高配额

3002 - 配额已用尽

解决:等待配额重置(通常每月重置)或升级套餐。

3003 - 连接数超限

解决
  • 调用 GET /v1/connections 查看当前连接
  • 调用 DELETE /v1/connections/:id 关闭多余连接

3004 - 订阅数超限

解决:取消部分订阅后再订阅新品种。

WebSocket 错误 (4xxx)

4001 - 未知命令

解决:检查 cmd 字段,支持的命令:subscribeunsubscribeping

4002 - 消息格式错误

解决:确保发送的是有效 JSON,包含必需字段。

4003 / 4004 - 订阅暂不可用

解决:使用 HTTP API 获取数据。

服务错误 (5xxx)

5000 - 服务器内部错误

解决:稍后重试。如持续出现,请联系技术支持。

5001 - 数据源不可用

解决:稍后重试,通常会自动恢复。

5002 - 服务暂时不可用

解决:服务可能正在维护,稍后重试。

错误处理示例

JavaScript

Python


如有疑问,请联系技术支持。