Polymarket API reference / CLOB API
POST/batch-prices-history

Get batch prices history

Retrieve historical price data for multiple markets in a single request.

Base URL
https://clob.polymarket.com
Auth
Public, no key
Rate limit
9,000 req / 10s (900 per second)
Limit applies to
CLOB API general

Request body

FieldTypeRequiredDescription
marketsstring[]yesList of market asset ids to query. Maximum 20.
start_tsnumbernoFilter by items after this unix timestamp (seconds).
end_tsnumbernoFilter by items before this unix timestamp (seconds).
intervalstringnoTime interval for data aggregation.
fidelityintegernoAccuracy of the data expressed in minutes. Default is 1 minute.

Example

curl -X POST "https://clob.polymarket.com/batch-prices-history" \
  -H "Content-Type: application/json" \
  -d '{
  "markets": []
}'

Response fields

FieldTypeDescription
historyobjectMap of market asset id to array of price data points.

Responses

StatusMeaning
200Successful response with price history for each market
400Bad Request - Missing or invalid parameters
500Internal server error
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.