v1
latestOpenAPI 3.1.02026-07-2657157254.1 KBpolymarket
Get Candlesticks By Token
Fetch historical candlestick data for a single outcome token.
Returns raw OHLCV data for this specific token — no YES/NO normalization is applied, so NO-token prices stay as NO prices (e.g. ~$0.30 in a 70/30 market). Volume is only from trades of this token; summing the YES and NO token volumes over the same window approximates the condition-level volume.
get/v2/polymarket/candlesticks/token/{token_id}
Path parameters
token_idstring required
Outcome token ID
Outcome token ID
Query parameters
start_timeinteger nullable
Unix timestamp (seconds) for start of time range
Unix timestamp (seconds) for start of time range
end_timeinteger nullable
Unix timestamp (seconds) for end of time range
Unix timestamp (seconds) for end of time range
intervalinteger
Interval: 0=auto, 1=1m, 5=5m, 15=15m, 60=1h, 1440=1d
Interval: 0=auto, 1=1m, 5=5m, 15=15m, 60=1h, 1440=1d
Response
Successful Response