Error Codes

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

The error JSON payload

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

10xx - General Server or Network issues

-1000 UNKNOWN

• An unknown error occurred while processing the request.

-1001 DISCONNECTED

• Internal error; unable to process your request. Please try again.

-1002 UNAUTHORIZED

• You are not authorized to execute this request.

-1003 TOO_MANY_REQUESTS

• Too many requests queued.
• Too much request weight used; current limit is %s request weight per %s. Please use WebSocket Streams for live updates to avoid polling the API.
• Way too much request weight used; IP banned until %s. Please use WebSocket Streams for live updates to avoid bans.

-1006 UNEXPECTED_RESP

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

-1007 TIMEOUT

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

-1014 UNKNOWN_ORDER_COMPOSITION

• Unsupported order combination.

-1015 TOO_MANY_ORDERS

• Reach the rate limit .Please slow down your request speed.
• Too many new orders.
• Too many new orders; current limit is %s orders per %s.

-1016 SERVICE_SHUTTING_DOWN

• This service is no longer available.

-1020 UNSUPPORTED_OPERATION

• This operation is not supported.

-1021 INVALID_TIMESTAMP

• Timestamp for this request is outside of the recvWindow.
• Timestamp for this request was 1000ms ahead of the server's time.
• Please check the difference between your local time and server time .

-1022 INVALID_SIGNATURE

• Signature for this request is not valid.

11xx - 2xxx Request issues

-1100 ILLEGAL_CHARS

• Illegal characters found in a parameter.
• Illegal characters found in parameter '%s'; legal range is '%s'.

-1101 TOO_MANY_PARAMETERS

• Too many parameters sent for this endpoint.
• Too many parameters; expected '%s' and received '%s'.
• Duplicate values for a parameter detected.

-1102 MANDATORY_PARAM_EMPTY_OR_MALFORMED

• A mandatory parameter was not sent, was empty/null, or malformed.
• Mandatory parameter '%s' was not sent, was empty/null, or malformed.
• Param '%s' or '%s' must be sent, but both were empty/null!

-1103 UNKNOWN_PARAM

• An unknown parameter was sent.
• In BBEx Open Api , each request requires at least one parameter. {Timestamp}.

-1104 UNREAD_PARAMETERS

• Not all sent parameters were read.
• Not all sent parameters were read; read '%s' parameter(s) but was sent '%s'.

-1105 PARAM_EMPTY

• A parameter was empty.
• Parameter '%s' was empty.

-1106 PARAM_NOT_REQUIRED

• A parameter was sent when not required.
• Parameter '%s' sent when not required.

-1111 BAD_PRECISION

• Precision is over the maximum defined for this asset.

-1112 NO_DEPTH

• No orders on book for symbol.

-1114 TIF_NOT_REQUIRED

• TimeInForce parameter sent when not required.

-1115 INVALID_TIF

• Invalid timeInForce.
• In the current version, this parameter is either empty or GTC.

-1116 INVALID_ORDER_TYPE

• Invalid orderType.
• In the current version , ORDER_TYPE values is LIMIT or MARKET.

-1117 INVALID_SIDE

• Invalid side.
• ORDER_SIDE values is BUY or SELL

-1118 EMPTY_NEW_CL_ORD_ID

• New client order ID was empty.

-1119 EMPTY_ORG_CL_ORD_ID

• Original client order ID was empty.

-1120 BAD_INTERVAL

• Invalid interval.

-1121 BAD_SYMBOL

• Invalid symbol.

-1125 INVALID_LISTEN_KEY

• This listenKey does not exist.

-1127 MORE_THAN_XX_HOURS

• Lookup interval is too big.
• More than %s hours between startTime and endTime.

-1128 OPTIONAL_PARAMS_BAD_COMBO

• Combination of optional parameters invalid.

-1130 INVALID_PARAMETER

• Invalid data sent for a parameter.
• Data sent for paramter '%s' is not valid.

-1132 ORDER_PRICE_TOO_HIGH

• Order price too high.

-1133 ORDER_PRICE_TOO_SMALL

• Order price lower than the minimum,please check general broker info.

-1134 ORDER_PRICE_PRECISION_TOO_LONG

• Order price decimal too long,please check general broker info.

-1135 ORDER_QUANTITY_TOO_BIG

• Order quantity too large.

-1136 ORDER_QUANTITY_TOO_SMALL

• Order quantity lower than the minimum.

-1137 ORDER_QUANTITY_PRECISION_TOO_LONG

• Order quantity decimal too long.

-1138 ORDER_PRICE_WAVE_EXCEED

• Order price exceeds permissible range.

-1139 ORDER_HAS_FILLED

• Order has been filled.

-1140 ORDER_AMOUNT_TOO_SMALL

• Transaction amount lower than the minimum.

-1141 ORDER_DUPLICATED

• Duplicate clientOrderId

-1142 ORDER_CANCELLED

• Order has been canceled

-1143 ORDER_NOT_FOUND_ON_ORDER_BOOK

• Cannot be found on order book

-1144 ORDER_LOCKED

• Order has been locked

-1145 ORDER_NOT_SUPPORT_CANCELLATION

• This order type does not support cancellation

-1146 ORDER_CREATION_TIMEOUT

• Order creation timeout

-1147 ORDER_CANCELLATION_TIMEOUT

• Order cancellation timeout

-1164 ERROR_AUTO_ADD_MARGIN

• Auto add margin error

-1165 INVALID_STOP_TYPE

• Invalid stopType.

-1166 INVALID_CALLBACK_TYPE

• Invalid callbackType.

-1193 ORDER_COUNT_LIMIT

• Create order count limit

-1194 MARKET_ORDER_FORBIDDEN

• Create market order forbidden

-1195 LIMIT_ORDER_PRICE_TOO_SMALL

• Create limit order price too small

-1196 LIMIT_ORDER_PRICE_TOO_BIG

• Create limit order price too big

-1197 LIMIT_ORDER_BUY_PRICE_TOO_BIG

• Create limit order buy price too big

-1198 LIMIT_ORDER_SELL_PRICE_TOO_SMALL

• Create limit order sell price too small

-1199 ORDER_BUY_QUANTITY_TOO_SMALL

• Create order buy quantity too small

-1200 ORDER_BUY_QUANTITY_TOO_BIG

• Create order buy quantity too big

-1201 LIMIT_ORDER_SELL_PRICE_TOO_BIG

• Create limit order sell price too big

-1202 ORDER_SELL_QUANTITY_TOO_SMALL

• Create order sell quantity too small

-1203 ORDER_SELL_QUANTITY_TOO_BIG

• Create order sell quantity too big

-2010 NEW_ORDER_REJECTED

• New order rejected

-2011 CANCEL_REJECTED

• Cancel order rejected

-2013 NO_SUCH_ORDER

• Order does not exist.

-2014 BAD_API_KEY_FMT

• API-key format invalid.

-2015 REJECTED_MBX_KEY

• Invalid API-key, IP, or permissions for action.

-2016 NO_TRADING_WINDOW

• No trading window could be found for the symbol. Try ticker/24hrs instead.

3xxx - Filters and other Issues

-3050 CREATE_API_KEY_EXCEED_LIMIT

• The ApiKey corresponding to the account already exists

-3101 OPEN_MARGIN_ACCOUNT_ERROR

• Open margin account error

-3102 GET_MARGIN_SAFETY_ERROR

• Get margin safety error

-3103 RISK_IS_NOT_EXIT

• Risk config is not exit

-3105 MARGIN_TOKEN_NOT_BORROW

• Token can not borrow

-3107 MARGIN_TOKEN_NOT_WITHDRAW

• Token can not withdraw

-3108 GET_AVAIL_WITHDRAW_ERROR

• Get token avail withdraw error

-3109 MARGIN_WITHDRAW_ERROR

• Margin withdraw failed

-3110 MARGIN_AVAIL_WITHDRAW_NOT_ENOUGH_FAILED

• Margin avail withdraw not enough failed

-3116 REPAY_ERROR

• Repay fail

-3117 GET_MARGIN_ALL_POSITION_ERROR

• Get margin all position fail

-3120 GET_REPAY_ORDER_ERROR

• Get repay order fail

-3124 POSITION_AND_ORDER_DATA_ERROR

• Position and order data error

-3125 POSITION_SIZE_CANNOT_MEET_TARGET_LEVERAGE_ERROR

• Position size cannot meet target leverage

-3126 ADJUST_LEVERAGE_FAIL

• Adjust leverage fail

-3127 ADJUST_LEVERAGE_TIMEOUT

• Adjust leverage timeout

-3128 ADJUST_MARGIN_TYPE_CHECK_FAILED

• The margin mode cannot be changed while you have an open order/position

-3129 CONE_FUTURES_CHANGE_POSITION_TYPE_ERROR

• Cone futures change position type error

-3130 ORDER_REJECT_FUTURES_ORDER_MARGIN_INSUFFICIENT

• Order margin insufficient

-3131 LEVERAGE_REDUCTION_IS_NOT_SUPPORTED

• Leverage reduction is not supported in Isolated Margin Mode with open positions.

-3151 SEPARATE_POSITION_MODE_NOT_SUPPORTED

• Separate position mode is not supported.