GET/books

Get order books (query parameters)

Retrieves order book summaries for multiple token IDs using query parameters.

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

Parameters

Name	In	Type	Required	Description
token_ids	query	string	yes	Comma-separated list of token IDs

Example

curl -X GET "https://clob.polymarket.com/books?token_ids=<token_ids>"

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

Related endpoints

GET /book CLOB API
POST /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.