> For the complete documentation index, see [llms.txt](https://docs.coinlocally.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coinlocally.com/error.md).

# Error

All API errors follow a standard JSON format, consisting of an **error code** and a **message**:

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

> ⚠️ **Note**: Error codes are standardized, but messages may vary slightly depending on the context.

***

### 🔧 General Server & Network Errors

| Code      | Description                                                                                        |
| --------- | -------------------------------------------------------------------------------------------------- |
| **-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

| Code      | Description                                                                                                                                 |
| --------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| **-1100** | Illegal characters in a parameter.                                                                                                          |
| **-1101** | Too many parameters sent to this endpoint.                                                                                                  |
| **-1102** | <p>A required parameter was missing, empty, or malformed.<br><em>E.g. <code>Mandatory parameter '%s' not sent or malformed.</code></em></p> |
| **-1103** | <p>Unknown parameter included.<br><em>Each request must include at least one valid parameter (e.g., <code>timestamp</code>).</em></p>       |
| **-1104** | <p>Not all parameters were read.<br><em>Expected '%s', received '%s'.</em></p>                                                              |
| **-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

| Code      | Description                                                       |
| --------- | ----------------------------------------------------------------- |
| **-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.
