Order Book

Returns the current order book snapshot for a token.

GET /v1/orderbook/{token_id}

Order Book

cURL

curl --request GET \
  --url https://api.example.com/v1/orderbook/{token_id}

Path Parameters

token_id · string · required

Token ID.

Response

{
  "token_id": "21742633143463...",
  "bids": [
    {"price": 0.71, "size": 5000.00},
    {"price": 0.70, "size": 12000.00},
    {"price": 0.69, "size": 8000.00}
  ],
  "asks": [
    {"price": 0.73, "size": 3000.00},
    {"price": 0.74, "size": 7000.00},
    {"price": 0.75, "size": 10000.00}
  ],
  "last_updated": "2026-03-23T15:30:05Z"
}

Order books are polled from Polymarket’s CLOB every 10 seconds and cached in Redis. The last_updated field indicates when the snapshot was taken.

Errors

Status	Description
404	No orderbook data for this token