​

Errors

{
  "error": {
    "message": "Human-readable explanation.",
    "code": 400,
    "details": {  }
  }
}

​

Programming against errors

1. Check the HTTP status first.
2. If error.details.code is present, branch on that (it is stable across releases). The throttle codes documented on Rate limits are the main consumers of this.
3. For everything else, the HTTP status + endpoint context is enough. Do not parse error.message — those strings are not part of the contract and may change.

​

Common errors by status

​

400 — Bad request

• Missing required field (e.g. Username and password are required on /user/login).
• Invalid gameID (Invalid gameID: <id> on any endpoint that looks up a game).
• Invalid playerMode (must be "coins" or "cash" — see Switch player mode).
• Order size below MIN_ORDER_SIZE or above the configured maximum.

{
  "error": {
    "message": "Invalid gameID: evt_001",
    "code": 400
  }
}

​

401 — Unauthorized

{
  "error": {
    "message": "InvalidCredentials",
    "code": 401
  }
}

​

403 — Forbidden

• Resource ownership: Not your order: <orderID> when you try to cancel or look up an order another user owns.
• Account restrictions: USER IS BANNED, Your account <username> has been closed, or a permission flag (e.g. admin-only endpoints).
• Limits: Order size exceeds maximum limit of 1000.00 on place/edit.

{
  "error": {
    "message": "Not your order: 507f1f77bcf86cd799439011",
    "code": 403
  }
}

​

404 — Not found

{
  "error": {
    "message": "Redemption request not found.",
    "code": 404
  }
}

​

409 — Conflict

• "Order size exceeds quantity available, which is $X.XX" — the resting offer you tried to take was partially or fully consumed by another taker before your request landed.
• "Odds have been edited" — the maker edited their order between your read and your take.
• "Session is expired" / "Session is cancelled" — the order you targeted is no longer takeable.
• "Game is past start time" / "Game has started" / "Game has been taken OTB or is graded" — the market closed (or moved to in-play) between your read and your write.
• "You cannot fill your own order: <orderID>" — you are the maker of the order you tried to take. Only enforced in cash mode.
• "Order size exceeds available credit" / "Exceeds max liability <N>" — your available credit / max liability changed (e.g. a concurrent order on the other side of your book).

{
  "error": {
    "message": "Order size exceeds quantity available, which is $42.50",
    "code": 409
  }
}

1. Catch the 409.
2. Refresh the orderbook for the affected gameID (and orderbook depth on the side you wanted).
3. Decide whether the new state still matches your strategy. If yes, place a new order against the current best offer; if no, abandon.

​

423 — Locked

​

429 — Too many requests

​

500 — Server error

{
  "error": {
    "message": "Something went wrong",
    "code": 500
  }
}