Polymarket errors / Query Orders
500 Internal Server ErrorSafe to retry

Internal server error

An unexpected error occurred while fetching the order.

Retry? Safe to retry

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

Returned by

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 "Internal server error" 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.