Error
All API errors follow a standard JSON format, consisting of an error code and a message:
⚠️ Note: Error codes are standardized, but messages may vary slightly depending on the context.
🔧 General Server & Network Errors
-1000
Unknown error occurred while processing the request.
-1001
Internal server error. Please retry your request.
-1002
Unauthorized: API Key not provided or invalid. Include your API Key in all requests.
-1003
Request rate too high. You've exceeded the limit.
-1004
Unauthorized access. User not found or not associated with a company.
-1006
Unexpected response from internal system. Execution status unknown. Contact support.
-1007
Backend server timeout. Status of request is unknown.
-1014
Unsupported order combination.
-1015
Too many new orders placed in a short time.
-1016
This service is no longer available.
-1017
Missing or incorrect Content-Type
. Ensure all headers include: Content-Type: application/json
.
-1020
Operation not supported.
-1021
Timestamp is outside the allowed recvWindow
. Check time sync with server.
-1022
Signature is invalid. Ensure the signature string is correctly constructed.
-1023
Missing timestamp. Add the X-CH-TS
header to your request.
-1024
Missing signature. Add the X-CH-SIGN
header to your request.
📝 Request Format & Parameter Errors
-1100
Illegal characters in a parameter.
-1101
Too many parameters sent to this endpoint.
-1102
A required parameter was missing, empty, or malformed.
E.g. Mandatory parameter '%s' not sent or malformed.
-1103
Unknown parameter included.
Each request must include at least one valid parameter (e.g., timestamp
).
-1104
Not all parameters were read. Expected '%s', received '%s'.
-1105
Parameter was empty.
-1106
Parameter sent when not required.
-1111
Precision exceeds allowed maximum for this asset.
-1112
No orders currently on the order book for this symbol.
-1116
Invalid orderType
. Must be LIMIT
or MARKET
.
-1117
Invalid side
. Must be BUY
or SELL
.
-1118
newClientOrderId
is empty. This must be a unique string.
-1121
Invalid symbol. Check trading pair spelling or availability.
-1136
Order volume is below the minimum allowed.
-1138
Order price exceeds the allowed range.
-1139
This trading pair does not support market orders.
-1145
This order type cannot be canceled.
📈 Trading & Account Errors
-2013
Order not found. It may have been filled or canceled already.
-2015
Invalid API Key, IP, or insufficient permissions for this action.
-2016
Transaction is currently frozen. Contact support.
-2017
Insufficient balance to place this order.
🔍 Tips for Debugging
Always log the full request: method, endpoint, timestamp, and body.
Ensure system clocks are synced to avoid timestamp-related errors.
Verify the signature format and ordering match the API documentation exactly.
Avoid high-frequency bursts that could trigger rate limit errors.
Last updated