> For the complete documentation index, see [llms.txt](https://ajaib.gitbook.io/ajaib-exchange-open-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajaib.gitbook.io/ajaib-exchange-open-api/api-references/general-information/error-codes.md).

# Error Codes

Errors consist of two parts: an error code and a message. Codes are universal, but messages can vary. Here is the error JSON payload:

```
{
  "code":-1121,
  "msg":"Invalid symbol."
}
```

### 10xx - General Server or Network issues <a href="#id-10xx---general-server-or-network-issues" id="id-10xx---general-server-or-network-issues"></a>

#### -1000 UNKNOWN <a href="#id-1000-unknown" id="id-1000-unknown"></a>

* An unknown error occurred while processing the request.

#### -1002 UNAUTHORIZED <a href="#id-1002-unauthorized" id="id-1002-unauthorized"></a>

* You are not authorized to execute this request.

#### -1006 UNEXPECTED\_RESP <a href="#id-1006-unexpected_resp" id="id-1006-unexpected_resp"></a>

* An unexpected response was received from the message bus. Execution status unknown.

#### -1007 TIMEOUT <a href="#id-1007-timeout" id="id-1007-timeout"></a>

* Timeout waiting for response from backend server. Send status unknown; execution status unknown.

#### -1013 INVALID\_MESSAGE <a href="#id-1013-invalid_message" id="id-1013-invalid_message"></a>

* The request is rejected by the API. (i.e. The request didn't reach the Matching Engine.)
* Potential error messages can be found in [Filter Failures](https://app.gitbook.com/o/LdxNUhLARU4i5PWgRIYE/s/QFDWMfeUb31y6zAF2lKc/~/changes/87/api-references/general-information/error-codes/~/overview#filter-failures) or [Failures during order placement](https://app.gitbook.com/o/LdxNUhLARU4i5PWgRIYE/s/QFDWMfeUb31y6zAF2lKc/~/changes/87/api-references/general-information/error-codes/~/overview#messages-for--1010-error_msg_received--2010-new_order_rejected--2011-cancel_rejected-and--2038-order).

#### -1021 INVALID\_TIMESTAMP <a href="#id-1021-invalid_timestamp" id="id-1021-invalid_timestamp"></a>

* Timestamp and/or recvWindow is invalid
* Timestamp must be greater than zero
* Timestamp is inconsistent with server time
* Timestamp expired

### 11xx - Request issues <a href="#id-11xx---request-issues" id="id-11xx---request-issues"></a>

#### -1102 MANDATORY\_PARAM\_EMPTY\_OR\_MALFORMED <a href="#id-1102-mandatory_param_empty_or_malformed" id="id-1102-mandatory_param_empty_or_malformed"></a>

* A mandatory parameter was not sent, was empty/null, or malformed.
* Invalid '%s' format
* '%s' is empty
* '%s' is in the wrong format

#### -1116 INVALID\_ORDER\_TYPE <a href="#id-1116-invalid_order_type" id="id-1116-invalid_order_type"></a>

* Invalid order type.

#### -1117 INVALID\_SIDE <a href="#id-1117-invalid_side" id="id-1117-invalid_side"></a>

* Invalid side.

#### -1121 BAD\_SYMBOL <a href="#id-1121-bad_symbol" id="id-1121-bad_symbol"></a>

* Invalid symbol.

#### -1122 INVALID\_SYMBOL\_STATUS <a href="#id-1122-invalid_symbolstatus" id="id-1122-invalid_symbolstatus"></a>

* Invalid symbol status.

#### -1130 INVALID\_PARAMETER <a href="#id-1130-invalid_parameter" id="id-1130-invalid_parameter"></a>

* Invalid data sent for a parameter.
* '%s' is required.

#### -1182 PARAMS\_BAD\_COMBO <a href="#id-1182-params_bad_combo" id="id-1182-params_bad_combo"></a>

* Conflicting fields: \[%s]
* orderId cannot be used with startTime or endTime

#### -2010 NEW\_ORDER\_REJECTED <a href="#id-2010-new_order_rejected" id="id-2010-new_order_rejected"></a>

* Create rejected.
* Account has insufficient balance for requested action.

#### -2011 CANCEL\_REJECTED <a href="#id-2011-cancel_rejected" id="id-2011-cancel_rejected"></a>

* Cancel rejected.

#### -2013 NO\_SUCH\_ORDER <a href="#id-2013-no_such_order" id="id-2013-no_such_order"></a>

* Order does not exist.

### Filter failures <a href="#filter-failures" id="filter-failures"></a>

| Error message                        | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| "Filter failure: PRICE\_FILTER" '%s' | <p><code>price</code> is too high, too low, and/or not following the tick size rule for the symbol. example messages:</p><ul><li>Filter failure: PRICE\_FILTER: price must be positive</li><li>Filter failure: PRICE\_FILTER: minimum price must be positive</li><li>Filter failure: PRICE\_FILTER: price must be greater than minimum %s</li><li>Filter failure: PRICE\_FILTER: price must be less than maximum %s</li><li>Filter failure: PRICE\_FILTER: order price %s is not divisible by tick price %s</li></ul>                       |
| "Filter failure: LOT\_SIZE"          | <p><code>quantity</code> is too high, too low, and/or not following the step size rule for the symbol. Example messages:</p><ul><li>Filter failure: LOT\_SIZE: quantity must be positive</li><li>Filter failure: LOT\_SIZE: quantity must be greater than minimum %s</li><li>Filter failure: LOT\_SIZE: quantity must be less than maximum %s</li><li>Filter failure: LOT\_SIZE: order quantity %s is not divisible by tick quantity %s</li><li>Filter failure: LOT\_SIZE: order quantity %s is not divisible by tick quantity %s</li></ul> |
| "Filter failure: MIN\_NOTIONAL"      | <p><code>price</code> \* <code>quantity</code> (<code>quoteOrderQty</code> for market buy) is too low to be a valid order for the symbol. Example messages:</p><ul><li>Filter failure: MIN\_NOTIONAL: amount must be positive</li><li>Filter failure: MIN\_NOTIONAL: amount must be greater or equal than minimum %s</li></ul>                                                                                                                                                                                                              |