Polymarket API reference / CLOB API
GET/prices-history

Get prices history

Retrieve historical price data for a market.

Base URL
https://clob.polymarket.com
Auth
Public, no key
Rate limit
1,000 req / 10s (100 per second)
Limit applies to
/prices-history

Things to know

For older markets, interval=max returns an empty list. Pass an explicit startTs and endTs to get the points Polymarket keeps, about one a minute at fidelity=1. The same data is also served by GET /v2/prices-history on the data host, which allows 200 requests per 10 seconds against 1,000 here.

Parameters

NameInTypeRequiredDescription
marketquerystringyesThe market (asset id) to query.
startTsquerynumbernoFilter by items after this unix timestamp.
endTsquerynumbernoFilter by items before this unix timestamp.
intervalquerystringnoTime interval for data aggregation.
fidelityqueryintegernoAccuracy of the data expressed in minutes. Default is 1 minute.

Example

curl -X GET "https://clob.polymarket.com/prices-history?market=<market>"

Response fields

FieldTypeDescription
historyobject[]

Responses

StatusMeaning
200Successful response with price history
400Bad Request - Missing or invalid query 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.