Comprehensive Error Code List
Last Updated: June 11, 2025
Binance REST API interfaces (including WAPI) return errors containing two components: an error code and an error message. The error code represents a broad category that may correspond to multiple specific error messages. Below is a complete error code example:
{
"code": -1121,
"msg": "Invalid symbol."
}Server & Network Issues (10xx Series)
-1000 Unknown Error
- Generic unidentified error condition
-1001 Disconnected
- Typically an internal issue; retrying usually resolves
-1002 Unauthorized
- Verify your API permissions
-1003 Rate Limit Exceeded
- Too many queued requests
- Current limit: %s request weight per %s
- Recommendation: Use Websocket Streams for real-time updates
-1006 Irregular Response
- Received malformed message format (order status unknown)
-1007 Timeout
- Backend service timeout (order status unknown)
-1008 Server Busy
- Spot trading server overloaded; retry later
-1013 Invalid Message
- API rejected request (never reached matching engine)
- Check "Order Filter Failures" section for details
-1014 Unsupported Order Combination
- Invalid parameter combination
Request Content Issues (11xx Series)
-1100 Illegal Characters
- Found in parameter '%s'; valid range: '%s'
-1101 Excessive Parameters
- Sent %s parameters (expected: %s)
-1102 Missing Required Parameter
- Mandatory parameter '%s' missing/empty
-1103 Unrecognized Parameter
- Unknown parameter detected
-1104 Redundant Parameter
- Only %s parameters read (sent: %s)
-1105 Empty Parameter
- Parameter '%s' contained no value
-1121 Invalid Symbol
- Unsupported trading pair
-1122 Invalid Symbol Status
- Trading pair not in valid state
Order Placement & Management Errors
-2010 New Order Rejected
- NEW_ORDER_REJECTED
-2011 Cancel Rejected
- CANCEL_REJECTED
-2013 Nonexistent Order
- Specified order not found
-2014 Invalid API Key Format
- Malformed API credential
-2026 Archived Trade
- Order canceled/expired over 90 days ago
Filter Failure Messages
| Error Message | Description |
|---|---|
| PRICE_FILTER | Price outside acceptable range |
| LOT_SIZE | Quantity violates size constraints |
| MIN_NOTIONAL | Order value below minimum threshold |
| TRAILING_DELTA | Invalid trailing stop parameters |
Frequently Asked Questions
Q: What should I do when receiving error -1021 (time synchronization)?
A: This indicates excessive latency between your system and Binance servers. Either improve your network conditions or increase the recvWindow parameter.
Q: How do I resolve error -1003 (rate limit exceeded)?
A: Implement request pacing according to documented limits. For real-time data, switch to Websocket Streams to reduce API calls.
Q: Why does my order fail with "Filter failure"?
A: This indicates your order parameters violate exchange trading rules. Carefully review the specific filter requirements for price, quantity, and other constraints.
Q: How can I prevent error -1022 (invalid signature)?
A: Double-check your API secret key and signature generation algorithm. Most often caused by incorrect secret key usage.
👉 Master API Trading with These Pro Tips
Q: What does error -2015 mean?
A: This signifies permission issues - either your API key lacks necessary privileges, originates from unauthorized IP, or accesses restricted endpoints.
Q: How to handle error -1015 (too many orders)?
A: Reduce your order frequency or cancel existing orders before submitting new ones. Consider consolidating smaller orders where possible.