响应格式
HTTP API
WebSocket
错误码速查表
详细说明
认证错误 (1xxx)
1001 - API Key 无效或已过期
- API Key 输入错误
- API Key 已被禁用
- API Key 已过期
1002 - 未提供 API Key
X-API-Key: your_api_key,或在 WebSocket URL 中添加 ?api_key=your_api_key。
1003 - IP 不在白名单
1004 - 权限不足
参数错误 (2xxx)
2001 - 参数错误
2002 - 交易品种不存在
GET /v1/symbols/available 获取可用品种列表。
2003 - 时间范围无效
- start_time 大于 end_time
- 时间格式错误
- 时间范围超出限制
2004 - 请求数量超限
limit 参数值(通常最大 1000)。
限流错误 (3xxx)
3001 - 请求频率超限
Retry-After 头,指示等待秒数。
解决:
- 降低请求频率
- 使用 WebSocket 订阅替代轮询
- 升级套餐获取更高配额
3002 - 配额已用尽
3003 - 连接数超限
- 调用
GET /v1/connections查看当前连接 - 调用
DELETE /v1/connections/:id关闭多余连接
3004 - 订阅数超限
WebSocket 错误 (4xxx)
4001 - 未知命令
cmd 字段,支持的命令:subscribe、unsubscribe、ping。
4002 - 消息格式错误
4003 / 4004 - 订阅暂不可用
服务错误 (5xxx)
5000 - 服务器内部错误
5001 - 数据源不可用
5002 - 服务暂时不可用
错误处理示例
JavaScript
Python
如有疑问,请联系技术支持。
