響應格式
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
如有疑問,請聯繫技術支持。
