Get Polymarket Price History
Retrieve price history for a Polymarket market. Each record shows the price at a point in time derived from trades.
What you get
- Exchange identifier
- Condition ID (market identifier)
- token_id: The token identifier for this price point
- outcome: The outcome label for this token (e.g., “Yes”, “No”, or a named outcome like “EDward Gaming”)
- Price (as decimal, e.g., 0.992 = 99.2%)
- Timestamp
Important This endpoint requires the condition_id (hex string starting with 0x), NOT the standard poly_id.
Use cases
- Build price charts
- Analyze price movements over time
- Track market sentiment
- Backtest trading strategies
Example
- Request:
GET /api/v1/poly/0x00000977017fa72fb6b1908ae694000d3b51f442c2552656b10bdbbfd16ff707/prices?limit=10 - Header:
X-API-Key: YOUR_API_KEY
Authorizations
Your API key (get one from the test-key endpoint above)
Path Parameters
Polymarket condition ID (hex string). This is different from the standard poly_id - it's the long identifier starting with '0x' that uniquely identifies a market condition.
Query Parameters
Maximum number of price points to return (default: 10 in docs, no max limit)
Response
Price history
Exchange identifier (PLY)
Polymarket condition ID (market identifier)
Token identifier for this price point
Outcome label for this token (e.g., Yes, No, or a named outcome)
Price as decimal (e.g., 0.992 = 99.2%)
Timestamp of the price point

