Skip to main content

Error Codes

Here is the error JSON payload:

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

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 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.

-1008 TOO_MANY_REQUESTS​

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

-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.

11xx - 2xxx Request issues​

-1100 ILLEGAL_CHARS​

  • Illegal characters found in a parameter.
  • Illegal characters found in a parameter. %s
  • 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.

-1111 BAD_PRECISION​

  • Precision is over the maximum defined for this asset.

-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.

-1127 MORE_THAN_XX_HOURS​

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

-1128 BAD_CONTRACT​

  • Invalid underlying

-1129 BAD_CURRENCY​

  • Invalid asset。

-1130 INVALID_PARAMETER​

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

-1131 BAD_RECV_WINDOW​

  • recvWindow must be less than 60000

-2010 NEW_ORDER_REJECTED​

  • NEW_ORDER_REJECTED

-2013 NO_SUCH_ORDER​

  • Order does not exist.

-2014 BAD_API_KEY_FMT​

  • API-key format invalid.

-2015 INVALID_API_KEY​

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

-2018 BALANCE_NOT_SUFFICIENT​

  • Balance is insufficient.

-2027 OPTION_MARGIN_NOT_SUFFICIENT​

  • Option margin is insufficient.

3xxx-5xxx Filters and other issues​

-3029 TRANSFER_FAILED​

  • Asset transfer fail.

-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.

-4013 PRICE_LESS_THAN_MIN_PRICE​

  • Price less than min price.

-4029 INVALID_TICK_SIZE_PRECISION​

  • Tick size precision is invalid.

-4030 INVALID_QTY_PRECISION​

  • Step size precision is invalid.

-4055 AMOUNT_MUST_BE_POSITIVE​

  • Amount must be positive.