Skip to main content

​
Overview

When a request fails, the API returns an errorCode field in the response body alongside "status": "failure". This page lists every error code by endpoint. 
{
  "status": "failure",
  "errorCode": "INVALID_ODDS"
}

​
POST /orders/new

These are returned in the statuses array for each submitted order. See POST /orders/new.
StatusDescription
OKOrder created successfully
INSUFFICIENT_BALANCEInsufficient maker token balance
INVALID_MARKETNon-unique marketHashes specified
ORDERS_ALREADY_EXISTThe order already exists
Request-level errors:
Error codeDescription
TOO_MANY_DIFFERENT_MARKETSMore than 3 different markets in a single request
ORDERS_MUST_HAVE_IDENTICAL_MARKETAll orders must be for the same network (SXN or SXR)
BAD_BASE_TOKENAll orders must be for the same base token

​
POST /orders/fill/v2

See POST /orders/fill/v2.
Error codeDescription
INSUFFICIENT_KYCThe taker has not met the minimum KYC level to fill
AFTER_ORDER_EXPIRYOne of the orders has expired
BASE_TOKENS_NOT_SAMEAll orders must be for the same baseToken
MARKETS_NOT_SAMEAll orders must be for the same market
DIRECTIONS_NOT_SAMEAll orders must be betting on the same side (isMakerBettingOutcomeOne)
INVALID_ORDERSOrder is now inactive
INVALID_ODDSInvalid desiredOdds — must be less than 10^20
INVALID_ODDS_SLIPPAGEInvalid oddsSlippage — must be an integer between 0 and 100
MATCH_STATE_INVALIDThe fixture is in an invalid state and is no longer bettable
TAKER_SIGNATURE_MISMATCHThe taker signature generated for the request is invalid
PROXY_ACCOUNT_INVALIDThe proxy account is invalid (only applicable if proxyTaker was specified)
TAKER_AMOUNT_TOO_LOWThe stakeWei specified is too low for the current token
META_TX_RATE_LIMIT_REACHEDCannot have more than 10 meta transactions at once
INSUFFICIENT_SPACENot enough space to fill the matched orders due to other pending fills
FILL_ALREADY_SUBMITTEDThe fill has already been submitted
ODDS_STALENo orders found for the desiredOdds and oddsSlippage — try again with greater slippage

​
POST /orders/cancel

See POST /orders/cancel.
Error codeDescription
CANCEL_REQUEST_ALREADY_PROCESSEDThis cancellation has already been processed

​
POST /orders/cancel/event

See POST /orders/cancel/event.
Error codeDescription
CANCEL_REQUEST_ALREADY_PROCESSEDThis cancellation has already been processed

​
POST /orders/cancel/all

See POST /orders/cancel/all.
Error codeDescription
CANCEL_REQUEST_ALREADY_PROCESSEDThis cancellation has already been processed

​
GET /orders

See GET /orders.
Error codeDescription
RATE_LIMIT_ORDER_REQUEST_MARKET_COUNTMore than 1,000 marketHashes queried
BOTH_SPORTXEVENTID_MARKETHASHES_PRESENTCannot send both marketHashes and sportXEventId — use one or the other

​
GET /markets/find

See GET /markets/find.
Error codeDescription
BAD_MARKET_HASHESInvalid marketHashes or more than 30 marketHashes queried