Page cover
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Error codes & enums

Standard error payload: `{"code": -1121, "msg": "Invalid symbol."}` (spot).

Futures wraps it as `{"code":"-1121","succ":false,"msgData":null,"msg":"..."}`.

Code
Name
Meaning

-1000

UNKNOWN

Unknown error (often a bad symbol/contract name).

-1001

DISCONNECTED

Internal error; unable to process. Retry.

-1002

UNAUTHORIZED

X-CH-APIKEY missing from headers.

-1003

TOO_MANY_REQUESTS

Requests too frequent; rate limit exceeded.

-1004

NO_THIS_COMPANY

User/company does not exist.

-1006

UNEXPECTED_RESP

Order status UNKNOWN (message-bus issue).

-1007

TIMEOUT

Backend timeout; send/exec status unknown.

-1014

UNKNOWN_ORDER_COMPOSITION

Unsupported order combination.

-1015

TOO_MANY_ORDERS

Order count exceeds the maximum.

-1016

SERVICE_SHUTTING_DOWN

Service no longer available.

-1017

NO_CONTENT_TYPE

Attach Content-Type: application/json.

-1020

UNSUPPORTED_OPERATION

Operation not supported.

-1021

INVALID_TIMESTAMP

Timestamp offset too large vs server time.

-1022

INVALID_SIGNATURE

Signature verification failed.

-1023

UNAUTHORIZED

X-CH-TS missing from headers.

-1024

UNAUTHORIZED

X-CH-SIGN missing from headers.

-1100

ILLEGAL_CHARS

Illegal characters in a parameter.

-1101

TOO_MANY_PARAMETERS

Too many parameters for this endpoint.

-1102

MANDATORY_PARAM_EMPTY

Required param null, missing or malformed.

-1103

UNKNOWN_PARAM

Unknown parameter sent.

-1104

UNREAD_PARAMETERS

Not all sent parameters were read.

-1105

(empty)

A required parameter was empty.

-1106

PARAM_NOT_REQUIRED

A parameter was sent when not required.

-1111

BAD_PRECISION

Precision exceeds the maximum for this asset.

-1112

(empty)

No pending orders / order to cancel does not exist.

-1116

INVALID_ORDER_TYPE

Must be LIMIT or MARKET.

-1117

INVALID_SIDE

Must be BUY or SELL.

-1121

BAD_SYMBOL

Invalid or missing symbol / contract.

-1136

ORDER_QUANTITY_TOO_SMALL

Order volume below the minimum.

-1138

ORDER_PRICE_WAVE_EXCEED

Order price outside permissible range.

-1139

ORDER_NOT_SUPPORT_MARKET

Pair does not support market trading.

-1145

(empty)

Order status does not allow cancellation.

-1147

PRICE_VOLUME_PRESION_ERROR

Price/quantity precision exceeds max.

-2013

NO_SUCH_ORDER

Order does not exist.

-2015

REJECTED_CH_KEY

Invalid key, IP not whitelisted, or no permission.

-2016

EXCHANGE_LOCK

Transactions frozen / exchange lock.

-2017

balance_not_enough

Insufficient balance.

-2100

PARAM_ERROR

Parameter error (futures-only code).

-2200

(empty)

Illegal / untrusted IP.

35

(empty)

Forbidden to order (account may be restricted).

10015

(empty)

Exceeded the close available (close/stop order with no open position).

Enums

  • Order status (live): spot create returns int 0, then GET returns NEW -> PENDING_CANCEL; futures INIT -> PENDING_CANCEL. Cancellation is ASYNC (returns PENDING_CANCEL, not immediate CANCELED).

  • Order types: LIMIT, MARKET.

  • Order sides: BUY, SELL.

  • Kline intervals: spot = 1min,5min,15min,30min,60min,1day,1week,1month (1h returns []); futures = 1min,5min,15min,30min,1h,1day,1week,1month. 4h is not accepted.

Last updated

Was this helpful?