Websocket

ERROR CODE

Possible error codes when subscribing

Code	Meaning
400	topic is invalid
403	login is required
404	topic does not exist
406	topic is required
509	exceed max subscription count limitation of 100 per time
509	exceed max subscription count limitation of 300 per session

Possible error codes when establishing WebSocket connection

Code	Meaning
401	token is invalid
509	exceed max session count limitation of 50
509	service busy, please retry later

Other error codes:

Code	Meaning
400	ping timeout
415	command type is invalid
500	system error
509	exceed max permits per second

GATEWAY ERROR CODE

1. Request Errors (`400xxx`)

Code	Message
`400001`	Please check the URL of your request.
`400002`	Invalid `KC-API-TIMESTAMP`.
`400003`	`KC-API-KEY` does not exist.
`400004`	Invalid `KC-API-PASSPHRASE`.
`400005`	Invalid `KC-API-SIGN`.
`400006`	Invalid request IP, the current client IP is: `%s`.
`400007`	Access denied, requires more permission.
`400008`	V1 & V2 API keys are no longer supported by this API. Please create a V3 API key.
`400009`	Invalid `KC-API-KEY-VERSION`.
`400010`	UID access denied, requires more permission.
`400011`	Session verification failed. (After the server returns the sessionId, the client must sign the request with its secret and send it back, but the signature is incorrect and does not match what the server expects.)
`400012`	Session verification has timed out. (After the server returns the sessionId, the client did not send the signed request within the allowed time window (e.g. 30 seconds), so the server aborted verification.)

2. Partner Errors (`4002xx`)

Code	Message
`400200`	Unknown partner.
`400201`	Invalid `KC-API-PARTNER-SIGN`.
`400202`	Invalid request IP.

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

Code	Message
`400301`	Operation restricted due to local laws, regulations, or policies in your country or region.
`400302`	Based on your IP, services are unavailable in your region due to regulations. Please contact support.
`400303`	Identity verification required to access full features.
`400304`	Please log in with your master account to complete identity verification.

4. Authorization Errors (`4004xx`)

Code	Message
`400400`	Invalid authorization token.
`400401`	Authorization is required.

5. Data Errors (`4001xx`)

Code	Message
`400101`	Invalid request data.
`400102`	Please check the parameters of your request.

6. Websocket Errors to disconnect

Code	Message
`420001`	Too many errors, disconnected. Please try again later.
`420002`	Error receiving data.

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

Code	Message
`429000`	Too many requests in a short period. Please retry later.(UID LIMIT)
`429001`	Too many total requests in a short period. Please retry later.(SYSTEM LIMIT)
`429002`	Too many requests in a short period. Please retry later. (MULTY LIMIT PER CONNECTION)

8. User Restriction Errors (`411xxx`)

Code	Message
`411200`	URL is in the user blacklist.

9. Server Errors (`5xxxxx`)

Code	Message
`500000`	Internal server error.
`501000`	The service has stopped running. Please disconnect: exiting
`503000`	Server is busy. Please retry later.
`504000`	Gateway timeout.
`505000`	Unknown error.

Modified at 2026-03-04 11:01:48