POST/books

Get order books (request body)

Retrieves order book summaries for multiple token IDs using a request body.

Base URL: https://clob.polymarket.com
Auth: Public, no key
Rate limit: 500 req / 10s (50 per second)
Limit applies to: /books

Request body

Field	Type	Required	Description
token_id	string	yes	Token ID (asset ID)
side	string	no	Order side (optional, not used for midpoint calculation)

Example

curl -X POST "https://clob.polymarket.com/books" \
  -H "Content-Type: application/json" \
  -d '[
  {
    "token_id": "<token_id>"
  }
]'

Returns a list of objects with these fields

Field	Type	Description
market	string	Market condition ID
asset_id	string	Token ID (asset ID)
timestamp	string	Timestamp of the order book snapshot
hash	string	Hash of the order book summary
bids	object[]	List of bid orders (sorted by price descending)
asks	object[]	List of ask orders (sorted by price ascending)
min_order_size	string	Minimum order size
tick_size	string	Minimum price increment (tick size)
neg_risk	boolean	Whether negative risk is enabled for this market
last_trade_price	string	Last trade price

Responses

Status	Meaning
200	Successfully retrieved order books
400	Bad request - Invalid payload

Errors this endpoint returns

Related endpoints

GET /book CLOB API
GET /books CLOB API

Polymarket's API serves current state only, so it cannot show what a market's book looked like after it resolved. PolyTest records Up/Down markets while they run and keeps the snapshots. Try it free, or read the full rate limit reference.

From Polymarket's published OpenAPI spec and rate-limit tables, synced 2026-10-04.