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


如有疑問,請聯繫技術支持。