Error Code Explanation

Error Codes Error responses generally consist of two parts: an error code and an error message. The error code is standardized, but the error message may vary. Below is an example of an error JSON payload:

java { "code": -1121, "msg": "Invalid symbol." } 10xx - General Server and Network Errors -1000 UNKNOWN An unknown error occurred while processing the request.

-1001 DISCONNECTED Internal error. Unable to process your request. Please try again.

-1002 UNAUTHORIZED You are not authorized to perform this request. An API key is required. We recommend attaching the API key in all request headers.

-1003 TOO_MANY_REQUESTS Request rate limit exceeded.

-1004 NO_THIS_COMPANY You are not authorized to perform this request. User not associated with any company.

-1006 UNEXPECTED_RESP Received a message that does not match the expected format. Order status is unknown.

-1007 TIMEOUT Timed out while waiting for a backend server response. Send status unknown; execution status unknown.

-1014 UNKNOWN_ORDER_COMPOSITION Unsupported order combination.

-1015 TOO_MANY_ORDERS Too many new orders. Please reduce the frequency of your requests.

-1016 SERVICE_SHUTTING_DOWN Server is shutting down.

-1017 ILLEGAL_CONTENT_TYPE We recommend including Content-Type: application/json in all request headers.

-1020 UNSUPPORTED_OPERATION This operation is not supported.

-1021 INVALID_TIMESTAMP Time delay too large. The server determined the elapsed time based on the request timestamp exceeded the recvWindow. Improve network conditions or increase the recvWindow.

Time offset too large. The client time is ahead of the server time by more than 1 second based on the request timestamp.

-1022 INVALID_SIGNATURE Invalid signature for this request.

-1023 UNTIMESTAMP You are not authorized to perform this request. We recommend including X-CH-TS in all request headers.

-1024 UNSIGNATURE You are not authorized to perform this request. We recommend including X-CH-SIGN in the request header.

11xx - Issues Within Request Content -1100 ILLEGAL_CHARS Illegal characters found in parameters.

-1101 TOO_MANY_PARAMETERS Too many parameters sent.

Duplicate parameter values detected.

-1102 MANDATORY_PARAM_EMPTY_OR_MALFORMED A mandatory parameter was not sent, is null/empty, or malformed.

Mandatory parameter '%s' was not sent, is null/empty, or malformed.

One of the required parameters '%s' or '%s' must be sent, but both are empty.

-1103 UNKNOWN_PARAM Unknown parameter sent.

Each request requires at least one parameter {Timestamp}.

-1104 UNREAD_PARAMETERS Not all parameters sent were read.

Not all parameters sent were read; parameter '%s' was read, but '%s' was sent.

-1105 PARAM_EMPTY Parameter is empty.

Parameter '%s' is empty.

-1106 PARAM_NOT_REQUIRED Parameter was sent when it was not required.

Parameter '%s' was sent when not required.

-1111 BAD_PRECISION Precision exceeds the maximum allowed for this asset.

-1112 NO_DEPTH No order book for the trading pair.

-1116 INVALID_ORDER_TYPE Invalid order type.

-1117 INVALID_SIDE Invalid order side (buy/sell).

-1118 EMPTY_NEW_CL_ORD_ID New client order ID is empty.

-1121 BAD_SYMBOL Invalid symbol.

-1136 ORDER_QUANTITY_TOO_SMALL Order quantity is below the minimum allowed.

-1138 ORDER_PRICE_WAVE_EXCEED Order price exceeds the allowed range.

-1139 ORDER_NOT_SUPPORT_MARKET Market orders are not supported for this trading pair.

-1145 ORDER_NOT_SUPPORT_CANCELLATION This order type does not support cancellation.

-1147 PRICE_VOLUME_PRESION_ERROR Order price or quantity exceeds maximum limits.

-2013 NO_SUCH_ORDER Order does not exist.

-2015 REJECTED_CH_KEY Invalid API key, IP, or permission.

-2016 EXCHANGE_LOCK Trading is currently frozen.

-2017 BALANCE_NOT_ENOUGH Insufficient balance.