Websocket

ERROR CODE

訂閱和取消訂閱可能返回的錯誤碼

錯誤碼	意思
400	topic 格式錯誤
403	沒有登陸，訂閱了私有 topic
404	topic 不存在
406	指令參數缺少 topic
509	超過每次 100 次的最大訂閱數限制
509	超過每次會話 300 的最大訂閱數限制

建立 WebSocket 連結可能返回的錯誤碼（返回錯誤碼後，連結會被關閉）

錯誤碼	意思
401	token 無效
509	超過最大會話數量限制 50
509	服務繁忙，請稍後再試

其他錯誤碼:

錯誤碼	意思
400	心跳超時，斷開連接
415	指令 type 錯誤
500	伺服器異常
509	發送指令頻繁，超過限制，會斷開連線

GATEWAY ERROR CODE

1. 請求錯誤 (`400xxx`)

Code	Message
`400001`	請檢查您的請求URL。
`400002`	無效的 `KC-API-TIMESTAMP`.
`400003`	`KC-API-KEY` 不存在。
`400004`	無效的 `KC-API-PASSPHRASE`.
`400005`	無效的 `KC-API-SIGN`.
`400006`	無效的請求IP，當前客戶端IP為 `%s`.
`400007`	存取被拒絕，需要更多權限。
`400008`	此API不再支援V1和V2 API密鑰。請創建V3 API密鑰。
`400009`	無效的 `KC-API-KEY-VERSION`.
`400010`	UID存取被拒絕，需要更多權限。
`400011`	會話驗證失敗。（服務器返回sessionId後，客戶端必須使用其密鑰簽署請求並回傳，但簽名不正確，與服務器預期不符。）
`400012`	會話驗證已超時。（服務器返回sessionId後，客戶端未在允許的時間窗口（例如30秒）內發送簽署的請求，因此服務器中止驗證。

2. Partner Errors (`4002xx`)

Code	Message
`400200`	未知的合作夥伴。
`400201`	無效的 `KC-API-PARTNER-SIGN`.
`400202`	無效的請求IP。

3. Regional & KYC Limitations (`4003xx`)

Code	Message
`400301`	由於您所在國家或地區的當地法律、規定或政策，操作受到限制。
`400302`	根據您的IP，由於法規限制，您的地區無法使用服務。請聯繫支援。
`400303`	需要進行身份驗證以存取全部功能。
`400304`	請使用您的主帳戶登錄以完成身份驗證。

4. Authorization Errors (`4004xx`)

Code	Message
`400400`	無效的授權令牌。
`400401`	需要授權。

5. Data Errors (`4001xx`)

Code	Message
`400101`	無效的請求數據。
`400102`	請檢查您的請求參數。

6. Websocket Errors to disconnect

Code	Message
`420001`	錯誤過多，已斷線。請稍後重試。
`420002`	接收數據時發生錯誤。

7. Rate Limiting & Frequency Errors (`429xxx`)

Code	Message
`429000`	短時間內請求過多，請稍後重試。（UID限制）
`429001`	短時間內總請求過多，請稍後重試。（系統限制）
`429002`	短時間內請求過多，請稍後重試。（每連接多重限制）

8. User Restriction Errors (`411xxx`)

Code	Message
`411200`	URL在使用者黑名單中。

9. Server Errors (`5xxxxx`)

Code	Message
`500000`	內部服務器錯誤。
`501000`	服務已停止運作。請斷開連線：正在退出（內部升級，斷開並重新連接）
`503000`	服務器忙碌，請稍後重試。
`504000`	網關超時。
`505000`	未知錯誤。

Modified at 2026-03-04 10:59:10