Polymarket errors / Order Processing Errors
500 Internal Server ErrorSafe to retry

order timed out

The exchange could not process the order before the request deadline. This typically happens during bursts of concurrent order submissions from the same account. The order was rejected before reaching the order book and can be safely resubmitted.

Retry? Safe to retry

This is transient. Retry with exponential backoff and random jitter so a fleet of workers doesn't retry in step.

Any authenticated CLOB endpoint can return this.

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 "order timed out" in msg:
        backoff_and_retry()

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