Error Codes
Here is the error JSON payload:
Errors consist of two parts: an error code and a message.
Codes are universal,but messages can vary.
#
10xx - General Server or Network issues#
-1000 UNKNOWN- An unknown error occured 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 many requests; please use the websocket for live updates.
- Too many requests; current limit is %s requests per minute. Please use the websocket for live updates to avoid polling the API.
- Way too many requests; IP banned until %s. Please use the websocket for live updates to avoid bans.
#
-1004 DUPLICATE_IP- This IP is already on the white list
#
-1005 NO_SUCH_IP- No such IP has been white listed
#
-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.
#
-1010 ERROR_MSG_RECEIVED- ERROR_MSG_RECEIVED.
#
-1011 NON_WHITE_LIST- This IP cannot access this route.
#
-1013 INVALID_MESSAGE- INVALID_MESSAGE.
#
-1014 UNKNOWN_ORDER_COMPOSITION- Unsupported order combination.
#
-1015 TOO_MANY_ORDERS- 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.
#
-1022 INVALID_SIGNATURE- Signature for this request is not valid.
#
-1023 START_TIME_GREATER_THAN_END_TIME- Start time is greater than end time.
#
11xx - 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.
#
-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.
#
-1108 BAD_ASSET- Invalid asset.
#
-1109 BAD_ACCOUNT- Invalid account.
#
-1110 BAD_INSTRUMENT_TYPE- Invalid symbolType.
#
-1111 BAD_PRECISION- Precision is over the maximum defined for this asset.
#
-1112 NO_DEPTH- No orders on book for symbol.
#
-1113 WITHDRAW_NOT_NEGATIVE- Withdrawal amount must be negative.
#
-1114 TIF_NOT_REQUIRED- TimeInForce parameter sent when not required.
#
-1115 INVALID_TIF- Invalid timeInForce.
#
-1116 INVALID_ORDER_TYPE- Invalid orderType.
#
-1117 INVALID_SIDE- Invalid side.
#
-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. Please use
POST /fapi/v1/listenKey
to recreatelistenKey
#
-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 parameter '%s' is not valid.
#
-1136 INVALID_NEW_ORDER_RESP_TYPE- Invalid newOrderRespType.
#
20xx - Processing Issues#
-2010 NEW_ORDER_REJECTED- NEW_ORDER_REJECTED
#
-2011 CANCEL_REJECTED- CANCEL_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.
#
-2018 BALANCE_NOT_SUFFICIENT- Balance is insufficient.
#
-2019 MARGIN_NOT_SUFFICIEN- Margin is insufficient.
#
-2020 UNABLE_TO_FILL- Unable to fill.
#
-2021 ORDER_WOULD_IMMEDIATELY_TRIGGER- Order would immediately trigger.
#
-2022 REDUCE_ONLY_REJECT- ReduceOnly Order is rejected.
#
-2023 USER_IN_LIQUIDATION- User in liquidation mode now.
#
-2024 POSITION_NOT_SUFFICIENT- Position is not sufficient.
#
-2025 MAX_OPEN_ORDER_EXCEEDED- Reach max open order limit.
#
-2026 REDUCE_ONLY_ORDER_TYPE_NOT_SUPPORTED- This OrderType is not supported when reduceOnly.
#
-2027 MAX_LEVERAGE_RATIO- Exceeded the maximum allowable position at current leverage.
#
-2028 MIN_LEVERAGE_RATIO- Leverage is smaller than permitted: insufficient margin balance.
#
40xx - Filters and other Issues#
-4000 INVALID_ORDER_STATUS- Invalid order status.
#
-4001 PRICE_LESS_THAN_ZERO- Price less than 0.
#
-4002 PRICE_GREATER_THAN_MAX_PRICE- Price greater than max price.
#
-4003 QTY_LESS_THAN_ZERO- Quantity less than zero.
#
-4004 QTY_LESS_THAN_MIN_QTY- Quantity less than min quantity.
#
-4005 QTY_GREATER_THAN_MAX_QTY- Quantity greater than max quantity.
#
-4006 STOP_PRICE_LESS_THAN_ZERO- Stop price less than zero.
#
-4007 STOP_PRICE_GREATER_THAN_MAX_PRICE- Stop price greater than max price.
#
-4008 TICK_SIZE_LESS_THAN_ZERO- Tick size less than zero.
#
-4009 MAX_PRICE_LESS_THAN_MIN_PRICE- Max price less than min price.
#
-4010 MAX_QTY_LESS_THAN_MIN_QTY- Max qty less than min qty.
#
-4011 STEP_SIZE_LESS_THAN_ZERO- Step size less than zero.
#
-4012 MAX_NUM_ORDERS_LESS_THAN_ZERO- Max mum orders less than zero.
#
-4013 PRICE_LESS_THAN_MIN_PRICE- Price less than min price.
#
-4014 PRICE_NOT_INCREASED_BY_TICK_SIZE- Price not increased by tick size.
#
-4015 INVALID_CL_ORD_ID_LEN- Client order id is not valid.
- Client order id length should not be more than 36 chars
#
-4016 PRICE_HIGHTER_THAN_MULTIPLIER_UP- Price is higher than mark price multiplier cap.
#
-4017 MULTIPLIER_UP_LESS_THAN_ZERO- Multiplier up less than zero.
#
-4018 MULTIPLIER_DOWN_LESS_THAN_ZERO- Multiplier down less than zero.
#
-4019 COMPOSITE_SCALE_OVERFLOW- Composite scale too large.
#
-4020 TARGET_STRATEGY_INVALID- Target strategy invalid for orderType '%s',reduceOnly '%b'.
#
-4021 INVALID_DEPTH_LIMIT- Invalid depth limit.
- '%s' is not valid depth limit.
#
-4022 WRONG_MARKET_STATUS- market status sent is not valid.
#
-4023 QTY_NOT_INCREASED_BY_STEP_SIZE- Qty not increased by step size.
#
-4024 PRICE_LOWER_THAN_MULTIPLIER_DOWN- Price is lower than mark price multiplier floor.
#
-4025 MULTIPLIER_DECIMAL_LESS_THAN_ZERO- Multiplier decimal less than zero.
#
-4026 COMMISSION_INVALID- Commission invalid.
%s
less than zero.%s
absolute value greater than%s
#
-4027 INVALID_ACCOUNT_TYPE- Invalid account type.
#
-4028 INVALID_LEVERAGE- Invalid leverage
- Leverage
%s
is not valid - Leverage
%s
already exist with%s
#
-4029 INVALID_TICK_SIZE_PRECISION- Tick size precision is invalid.
#
-4030 INVALID_STEP_SIZE_PRECISION- Step size precision is invalid.
#
-4031 INVALID_WORKING_TYPE- Invalid parameter working type
- Invalid parameter working type:
%s
#
-4032 EXCEED_MAX_CANCEL_ORDER_SIZE- Exceed maximum cancel order size.
- Invalid parameter working type:
%s
#
-4033 INSURANCE_ACCOUNT_NOT_FOUND- Insurance account not found.
#
-4044 INVALID_BALANCE_TYPE- Balance Type is invalid.
#
-4045 MAX_STOP_ORDER_EXCEEDED- Reach max stop order limit.
#
-4046 NO_NEED_TO_CHANGE_MARGIN_TYPE- No need to change margin type.
#
-4047 THERE_EXISTS_OPEN_ORDERS- Margin type cannot be changed if there exists open orders.
#
-4048 THERE_EXISTS_QUANTITY- Margin type cannot be changed if there exists position.
#
-4049 ADD_ISOLATED_MARGIN_REJECT- Add margin only support for isolated position.
#
-4050 CROSS_BALANCE_INSUFFICIENT- Cross balance insufficient.
#
-4051 ISOLATED_BALANCE_INSUFFICIENT- Isolated balance insufficient.
#
-4052 NO_NEED_TO_CHANGE_AUTO_ADD_MARGIN- No need to change auto add margin.
#
-4053 AUTO_ADD_CROSSED_MARGIN_REJECT- Auto add margin only support for isolated position.
#
-4054 ADD_ISOLATED_MARGIN_NO_POSITION_REJECT- Cannot add position margin: position is 0.
#
-4055 AMOUNT_MUST_BE_POSITIVE- Amount must be positive.
#
-4056 INVALID_API_KEY_TYPE- Invalid api key type.
#
-4057 INVALID_RSA_PUBLIC_KEY- Invalid api public key
#
-4058 MAX_PRICE_TOO_LARGE- maxPrice and priceDecimal too large,please check.
#
-4059 NO_NEED_TO_CHANGE_POSITION_SIDE- No need to change position side.
#
-4060 INVALID_POSITION_SIDE- Invalid position side.
#
-4061 POSITION_SIDE_NOT_MATCH- Order's position side does not match user's setting.
#
-4062 REDUCE_ONLY_CONFLICT- Invalid or improper reduceOnly value.
#
-4067 POSITION_SIDE_CHANGE_EXISTS_OPEN_ORDERS- Position side cannot be changed if there exists open orders.
#
-4068 POSITION_SIDE_CHANGE_EXISTS_QUANTITY- Position side cannot be changed if there exists position.
#
-4082 INVALID_BATCH_PLACE_ORDER_SIZE- Invalid number of batch place orders.
- Invalid number of batch place orders: %s
#
-4083 PLACE_BATCH_ORDERS_FAIL- Fail to place batch orders.
#
-4084 UPCOMING_METHOD- Method is not allowed currently. Upcoming soon.
#
-4086 INVALID_PRICE_SPREAD_THRESHOLD- Invalid price spread threshold.
#
-4087 INVALID_PAIR- Invalid pair.
#
-4088 INVALID_TIME_INTERVAL- Invalid time interval.
- Maximum time interval is %s days.
#
-4089 REDUCE_ONLY_ORDER_PERMISSION- User can only place reduce only order.
#
-4090 NO_PLACE_ORDER_PERMISSION- User can not place order currently.
#
-4104 INVALID_CONTRACT_TYPE- Invalid contract type.
#
-4110 INVALID_CLIENT_TRAN_ID_LEN- clientTranId is not valid.
- Client tran id length should be less than 64 chars.
#
-4111 DUPLICATED_CLIENT_TRAN_ID- clientTranId is duplicated.
- Client tran id should be unique within 7 days.
#
-4112 REDUCE_ONLY_MARGIN_CHECK_FAILED- ReduceOnly Order Failed. Please check your existing position and open orders.
#
-4113 MARKET_ORDER_REJECT- The counterparty's best price does not meet the PERCENT_PRICE filter limit.
#
-4135 INVALID_ACTIVATION_PRICE- Invalid activation price.
#
-4137 QUANTITY_EXISTS_WITH_CLOSE_POSITION- Quantity must be zero with closePosition equals true.
#
-4138 REDUCE_ONLY_MUST_BE_TRUE- Reduce only must be true with closePosition equals true.
#
-4139 ORDER_TYPE_CANNOT_BE_MKT- Order type can not be market if it's unable to cancel.
#
-4142 STRATEGY_INVALID_TRIGGER_PRICE- REJECT: take profit or stop order will be triggered immediately.
#
-4150 ISOLATED_LEVERAGE_REJECT_WITH_POSITION- Leverage reduction is not supported in Isolated Margin Mode with open positions.
#
-4151 PRICE_HIGHTER_THAN_STOP_MULTIPLIER_UP- Price is higher than stop price multiplier cap.
- Limit price can't be higher than %s.
#
-4152 PRICE_LOWER_THAN_STOP_MULTIPLIER_DOWN- Price is lower than stop price multiplier floor.
- Limit price can't be lower than %s.
#
-4154 STOP_PRICE_HIGHER_THAN_PRICE_MULTIPLIER_LIMIT- Stop price is higher than price multiplier cap.
- Stop price can't be higher than %s
#
-4155 STOP_PRICE_LOWER_THAN_PRICE_MULTIPLIER_LIMIT- PStop price is lower than price multiplier floor.
- Stop price can't be lower than %s
#
-4178 MIN_NOTIONAL- Order's notional must be no smaller than one (unless you choose reduce only)
- Order's notional must be no smaller than %s (unless you choose reduce only)
#
-4192 COOLING_OFF_PERIOD- Trade forbidden due to Cooling-off Period.
#
-4194 ADJUST_LEVERAGE_KYC_FAILED- Intermediate Personal Verification is required for adjusting leverage over 20x.
#
-4195 ADJUST_LEVERAGE_ONE_MONTH_FAILED- More than 20x leverage is available one month after account registration.
#
-4196 LIMIT_ORDER_ONLY- Only limit order is supported.
#
-4197 SAME_ORDER- No need to modify the order.
#
-4198 EXCEED_MAX_MODIFY_ORDER_LIMIT- Exceed maximum modify order limit.
#
-4199 MOVE_ORDER_NOT_ALLOWED_SYMBOL_REASON- Symbol is not in trading status. Order amendment is not permitted.
#
-4200 ADJUST_LEVERAGE_X_DAYS_FAILED- More than 20x leverage is available 30 days after Futures account registration.
- More than 20x leverage is available %s days after Futures account registration.
#
-4201 ADJUST_LEVERAGE_KYC_LIMIT- Users in this country has limited adjust leverage.
- Users in your location/country can only access a maximum leverage of %s
#
-4202 ADJUST_LEVERAGE_ACCOUNT_SYMBOL_FAILED- Current symbol leverage cannot exceed 20 when using position limit adjustment service.
#
-4188 ME_INVALID_TIMESTAMP- Timestamp for this request is outside of the ME recvWindow.