400 Bad RequestDon't retry
Invalid token id
The `token_id` query parameter is missing or not a valid token ID.
The token_id is missing or isn't a valid token. Each market has two, one per outcome, listed in clobTokenIds on the Gamma market object.
Retry? Don't retry
Sending the same request again returns the same error. Change the request first.
Returned by
- GET /book 1,500 req / 10s
- GET /price 1,500 req / 10s
- GET /midpoint 1,500 req / 10s
- GET /spread 9,000 req / 10s
- GET /last-trade-price 9,000 req / 10s
- GET /tick-size 9,000 req / 10s
- GET /neg-risk 9,000 req / 10s
Handling it in code
The CLOB API returns errors as {"error": "..."}. It also rewrites status codes by message, so branch on the text: anything containing "not found" becomes 404 and anything containing "unauthorized" becomes 401.
r = session.post(url, json=payload, headers=headers)
if r.status_code >= 400:
msg = r.json().get("error", "")
if "Invalid token id" in msg:
raise ValueError(msg) # fix the request, don't retryRelated errors
For errors Polymarket doesn't document, like "order manager not ready" or 403s from the edge, see the full error guide.
Message and status from Polymarket's error reference, synced 2026-10-04.