Error Codes Reference

Complete guide to error codes from all supported exchanges

System Errors (10001-10099)

10001
Price Required for Limit Order
You're trying to place a limit order but no price was provided. Either use market order (entry_order_type: "0") or provide a price for limit order (entry_order_type: "1").
Critical
10002
Rate Limit Exceeded
Too many requests sent. Please wait a moment before trying again.
Warning
10003
API Key Issue
Invalid API key or IP address not whitelisted. Check your API settings and ensure your server IP is whitelisted.
Critical
10004
Signature Error
Request signing failed. Check your API secret key and ensure it's correct.
Warning
10005
Permission Denied
Your API key doesn't have permission for this action. Enable trading permissions in API settings.
Warning
10006
Too Many Requests
Rate limit exceeded. Please slow down your trading requests.
Critical
10007
Invalid Timestamp
Request timestamp is invalid. Please check your system time is synchronized.
Warning
10010
Invalid API Key
API key format is incorrect. Please check your API key.
Critical
10016
Server Maintenance
Bybit is under maintenance. Please try again later.
Warning
10017
Invalid IP Address
Your IP address is not whitelisted for this API key. Add your server IP to API key whitelist.
Warning
10018
API Key Expired
Your API key has expired. Please generate a new one.
Warning

Order Errors (110001-110999)

110001
Order Too Large
Order quantity exceeds maximum allowed for this symbol. Reduce your order size.
Critical
110002
Price Too High
Order price exceeds maximum allowed for this symbol. Adjust your price.
Critical
110003
Price Too Low
Order price is below minimum allowed for this symbol. Increase your price.
Critical
110004
Insufficient Balance
Not enough wallet balance to place this order. Deposit funds or reduce order size.
Critical
110007
Order Too Small
Order quantity is below minimum allowed for this symbol. Increase your order size.
Critical
110010
Invalid Leverage
Leverage value is not allowed for this symbol. Check maximum leverage for this trading pair.
Warning
110011
Position Too Large
Position size exceeds maximum allowed for this symbol. Reduce your position size.
Critical
110013
Pair Not Available
Trading pair is not open for trading at the moment. Try again later.
Warning
110014
No Position to Close
No open position found to close for this symbol. Check your open positions.
Critical
110016
Position Mode Mismatch
Position mode doesn't match your account settings. Update position mode or account settings.
Critical
110017
Leverage Too High
Leverage exceeds maximum allowed for this symbol. Reduce leverage.
Warning
110022
Invalid Stop Loss
Stop loss price is invalid for this position. Adjust stop loss price.
Critical
110023
Invalid Take Profit
Take profit price is invalid for this position. Adjust take profit price.
Critical
110094
Order Value Too Small
Order value must be at least $5 USDT. Increase your quantity or use a higher price.
Critical

Account Errors (130001-130999)

130001
Account Not Found
Account not found. Verify your account is active.
Critical
130002
Account Suspended
Account has been suspended. Contact support.
Critical

Authentication Errors (1524xx)

152401
Access Key Does Not Exist
Please go to the API Management page and check if it exists and is in an active state. Verify your API key is correct.
Critical
152402
Access Key Has Expired
Please go to the API Management page and check if it exists and is in an active state. Generate a new API key if expired.
Critical
152404
Operation Not Supported
Please check the requestPath or API key permissions. Ensure your API key has trading permissions enabled.
Critical
152405
Timestamp Expired
Timestamp in header or signature has expired, need to be within 60s. Check your system time synchronization.
Warning
152406
IP Not Whitelisted
Your IP is not included in your API key's IP whitelist. Add your server IP address to the whitelist in API settings.
Critical
152407
Repeated Nonce
Reusing nonce within 60 seconds is not allowed. Ensure each request has a unique nonce.
Warning
152408
Passphrase Error
Incorrect passphrase provided. BloFin requires a passphrase for API authentication. Verify your passphrase is correct.
Critical
152409
Signature Verification Failed
Please refer to signature verification documentation. Check your secret key and signature generation process.
Critical
152410
Invalid Timestamp Format
The value of ACCESS-TIMESTAMP needs to be a millisecond timestamp, e.g: 1704038400000.
Critical

Parameter Errors (152xxx)

152001
Parameter Cannot Be Empty
Required parameter is missing or empty. Check your request includes all required fields.
Critical
152002
Parameter Error
Invalid parameter value provided. Verify parameter values match expected format.
Critical
152003
Missing Required Parameter
Either parameter {} or {} is required. Provide at least one of the required parameters.
Critical
152004
JSON Syntax Error
Please check if the parameter should be an array or an object. Validate your JSON format.
Critical
152014
Instrument ID Does Not Exist
The trading pair is not supported or invalid. Check the symbol format (e.g., BTC-USDT).
Critical

Account Errors (15xxx)

150003
Client ID Already Exists
This client order ID is already in use. Use a unique client order ID for each order.
Warning
150004
Insufficient Balance
Please adjust the amount and try again. Deposit funds or reduce order size.
Critical

Order Errors (102xxx)

102002
Duplicate Customized Order ID
This client order ID is already in use. Generate a unique order ID.
Critical
102005
Position Had Been Closed
The position you're trying to close is already closed. Check your open positions.
Warning
102014
Limit Order Exceeds Maximum Order Size Limit
Order size is too large for limit orders. Reduce your order quantity.
Critical
102015
Market Order Exceeds Maximum Order Size Limit
Order size is too large for market orders. Reduce your order quantity.
Critical
102022
No Positions to Close
Failed to place order. You don't have any positions of this contract. Turn off Reduce-only to continue.
Critical
102037
TP Trigger Price Too High
TP trigger price should be higher than the latest trading price. Adjust your take profit trigger price.
Warning
102038
SL Trigger Price Too Low
SL trigger price should be lower than the latest trading price. Adjust your stop loss trigger price.
Warning
102064
Buy Price Out of Range
Buy price is not within the price limit. Check current market price and adjust.
Critical
102065
Sell Price Out of Range
Sell price is not within the price limit. Check current market price and adjust.
Critical
102089
Position Mode Mismatch
Position mode doesn't match your account settings. Update position mode in account settings.
Critical

System Errors (103xxx)

103003
Insufficient USDT Margin
Order failed. Insufficient USDT margin in account. Deposit USDT or reduce position size.
Critical
103013
Internal Error
Unable to process your request. Please try again. If problem persists, contact support.
Critical

Leverage Errors (110xxx)

110006
Pending Cross Orders
You have pending cross orders. Please cancel them before adjusting your leverage.
Warning
110019
Setting Failed
Cancel any open orders, and close positions first before changing settings.
Warning

Success Codes

0
Success
Operation completed successfully.
Success
1000
Order Canceled
The order has been successfully canceled.
Success

Toobit Error Codes

Toobit uses similar error codes to Bybit. Common errors include:

10001
System Error
System error occurred. Please try again later.
Critical
10003
Invalid API Key
Invalid API key or IP not whitelisted. Check your API credentials.
Critical
110004
Insufficient Balance
Not enough wallet balance to place this order.
Critical
Note: For detailed Toobit error codes, refer to the Toobit API documentation.

Evedex Error Codes

Evedex uses standard HTTP status codes and custom error messages. Common errors include:

400
Bad Request
Invalid request format or parameters.
Critical
401
Unauthorized
Authentication failed. Check your API credentials.
Critical
403
Forbidden
Access denied. Check your API key permissions.
Critical
429
Too Many Requests
Rate limit exceeded. Please slow down your requests.
Warning
Note: For detailed Evedex error codes, refer to the Evedex API documentation.

Pionex Error Codes

Pionex uses standard HTTP status codes and custom error messages. Common errors include:

400
Bad Request
Invalid request parameters. Check your request format and required fields.
Warning
401
Unauthorized
Invalid API key or signature. Check your API credentials and signature generation.
Critical
403
Forbidden
API key doesn't have permission for this action. Check API key permissions.
Warning
404
Not Found
Requested resource not found. Check the endpoint URL and symbol format.
Warning
429
Too Many Requests
Rate limit exceeded. Please slow down your requests.
Warning
500
Internal Server Error
Pionex server error. Please try again later.
Critical
INVALID_SYMBOL
Invalid Symbol
Trading pair symbol is invalid. Use format BTC_USDT (with underscore).
Warning
INSUFFICIENT_BALANCE
Insufficient Balance
Not enough balance to place this order. Check your account balance.
Critical
INVALID_AMOUNT
Invalid Amount
Order amount is too small or invalid. Check minimum order size requirements.
Warning
INVALID_PRICE
Invalid Price
Price is invalid or out of range. Check price precision and limits.
Warning
Note: For detailed Pionex error codes, refer to the Pionex API documentation.

Kraken Error Codes

Kraken uses error arrays in responses. Common errors include:

EAPI:Invalid key
Invalid API Key
API key is invalid or not found. Check your API key.
Critical
EAPI:Invalid signature
Invalid Signature
Signature is invalid. Check your secret key and signature generation. Secret key must be Base64-encoded.
Critical
EOrder:Insufficient funds
Insufficient Funds
Not enough balance to place this order. Check your account balance.
Critical
EOrder:Invalid price
Invalid Price
Price is invalid or out of range. Check price precision and limits.
Warning
EOrder:Invalid volume
Invalid Volume
Order volume is too small or invalid. Check minimum order size requirements.
Warning
EOrder:Rate limit exceeded
Rate Limit Exceeded
Too many requests sent. Please wait a moment before trying again.
Warning
Note: For detailed Kraken error codes, refer to the Kraken API documentation.

System Errors

429
Too Many Requests
Rate limit exceeded. Please slow down your requests and wait before trying again.
Warning
400
Bad Request
Invalid request format or parameters. Check your request structure and required fields.
Critical
401
Unauthorized
Invalid API key, secret key, or passphrase. Check your API credentials.
Critical
403
Forbidden
API key doesn't have permission for this action. Check API key permissions.
Warning

Parameter Errors

00001
Time Interval Too Large
StartTime and endTime interval cannot be greater than specified number of days. Reduce the time range.
Warning
00171
Parameter Verification Failed
Parameter validation failed. Check all required parameters are present and correctly formatted.
Critical
01001
Parameter Must Be Greater Than 0
A parameter value must be greater than 0. Check your parameter values.
Warning
40001
Invalid Symbol
Trading pair symbol is invalid. Use format BTCUSDT (no separator).
Critical

Order Errors

40002
Insufficient Balance
Not enough balance to place this order. Deposit funds or reduce order size.
Critical
40003
Order Size Too Small
Order quantity is below minimum allowed for this symbol. Increase your order size.
Critical
40004
Order Size Too Large
Order quantity exceeds maximum allowed for this symbol. Reduce your order size.
Critical
40005
Invalid Price
Price is invalid or out of range. Check price precision and limits for this symbol.
Warning
40006
Invalid Leverage
Leverage value is not allowed for this symbol. Check maximum leverage for this trading pair.
Warning
40007
No Position to Close
No open position found to close for this symbol. Check your open positions.
Critical

Authentication Errors

40008
Invalid Signature
Request signature is invalid. Check your secret key, passphrase, and signature generation process.
Critical
40009
Invalid Timestamp
Request timestamp is invalid or expired. Check your system time is synchronized.
Warning
40010
IP Not Whitelisted
Your IP address is not whitelisted for this API key. Add your server IP to API key whitelist.
Critical

System Errors

429
Too Many Requests
Rate limit exceeded. Please slow down your requests and wait before trying again.
Warning
400
Bad Request
Invalid request format or parameters. Check your request structure and required fields.
Critical
401
Unauthorized
Invalid API key or signature. Check your API credentials and signature generation.
Critical
403
Forbidden
API key doesn't have permission for this action. Check API key permissions.
Warning

Parameter Errors

100001
Invalid Parameter
Request parameter is invalid or missing. Check all required parameters are present.
Critical
100002
Invalid Symbol
Trading pair symbol is invalid. Use format BTC-USDT (with hyphen).
Critical
100003
Invalid Order Type
Order type is invalid. Use valid order types (LIMIT, MARKET, etc.).
Warning

Order Errors

100004
Insufficient Balance
Not enough balance to place this order. Deposit funds or reduce order size.
Critical
100005
Order Size Too Small
Order quantity is below minimum allowed for this symbol. Increase your order size.
Critical
100006
Order Size Too Large
Order quantity exceeds maximum allowed for this symbol. Reduce your order size.
Critical
100007
Invalid Price
Price is invalid or out of range. Check price precision and limits for this symbol.
Warning
100008
Invalid Leverage
Leverage value is not allowed for this symbol. Check maximum leverage for this trading pair.
Warning
100009
No Position to Close
No open position found to close for this symbol. Check your open positions.
Critical

Authentication Errors

100010
Invalid Signature
Request signature is invalid. Check your secret key and signature generation process.
Critical
100011
Invalid Timestamp
Request timestamp is invalid or expired. Check your system time is synchronized.
Warning

System Errors

-1000
Unknown Error
An unknown error occurred. Please try again later.
Critical
-1001
Disconnected
Internal error; unable to process your request. Please try again.
Critical
-1002
Unauthorized
You are not authorized to execute this request. Check your API key and permissions.
Critical
-1003
Too Many Requests
Too many requests queued. Please slow down your requests.
Warning
-1006
Unexpected Response
An unexpected response was received from the message bus. Please try again.
Critical
-1007
Timeout
Timeout waiting for response from backend server. Please try again.
Warning

Parameter Errors

-1100
Illegal Characters
Illegal characters found in a parameter. Check parameter values.
Critical
-1101
Too Many Parameters
Too many parameters sent for this endpoint. Check your request parameters.
Warning
-1102
Mandatory Parameter Empty
A mandatory parameter was not sent, was empty/null, or malformed. Check all required parameters.
Critical
-1103
Unknown Parameter
An unknown parameter was sent. Check parameter names.
Warning
-1104
Unread Parameters
Not all sent parameters were read. Check parameter format.
Warning
-1105
Parameter Empty
A parameter was empty. Check all parameter values.
Critical
-1106
Parameter Not Required
A parameter was sent when not required. Remove unnecessary parameters.
Warning
-1111
Invalid Symbol
Invalid symbol format. Use format BTCUSDT (no separator).
Critical

Order Errors

-2010
New Order Rejected
New order rejected. Check order parameters and account status.
Critical
-2011
Cancel Rejected
Cancel order rejected. Order may have already been filled or canceled.
Warning
-2013
No Such Order
Order does not exist. Check order ID or symbol.
Warning
-2015
Invalid API Key
Invalid API-key, IP, or permissions for action. Check your API credentials.
Critical
-2019
Balance Insufficient
Account has insufficient balance for requested action. Deposit funds or reduce order size.
Critical
-2021
Order Would Immediately Match
Order would immediately match and take. Use POST /api/v3/order with TIME_IN_FORCE.
Warning
-2022
Reduce Only Order Rejected
Reduce only order rejected. No position to reduce.
Critical

Authentication Errors

-1022
Invalid Signature
Signature for this request is not valid. Check your secret key and signature generation.
Critical
-1021
Invalid Timestamp
Timestamp for this request is outside of the recvWindow. Check your system time.
Warning

OKX Error Codes

OKX uses error codes in responses. Common errors include:

0
Success
Operation completed successfully.
Info
50000
Invalid API Key
API key is invalid or not found. Check your API key.
Critical
50001
Invalid Signature
Signature is invalid. Check your secret key, passphrase, and signature generation.
Critical
50002
Invalid Timestamp
Request timestamp is invalid. Check your system time is synchronized.
Warning
50003
Invalid Request
Request parameters are invalid. Check your request format and required fields.
Warning
50004
Insufficient Balance
Not enough balance to place this order. Check your account balance.
Critical
50005
Invalid Instrument ID
Trading pair symbol is invalid. Use format BTC-USDT-SWAP (with -SWAP suffix for futures).
Warning
50008
Rate Limit Exceeded
Too many requests sent. Please wait a moment before trying again.
Warning
Note: For detailed OKX error codes, refer to the OKX API documentation.