v1
latestOpenAPI 3.0.32026-07-2618063.1 KBGet Candlesticks
Fetches historical candlestick data for a market identified by condition_id, over a specified interval.
get/polymarket/candlesticks/{condition_id}
Query parameters
start_timeinteger required
Example:1640995200
Unix timestamp (in seconds) for start of time range
end_timeinteger required
Example:1672531200
Unix timestamp (in seconds) for end of time range
interval1 | 60 | 1440
Interval length: 1 = 1m, 60 = 1h, 1440 = 1d. Defaults to 1m.
⚠️ Note: There are range limits for interval — specifically:
- 1 (1m): max range 1 week
- 60 (1h): max range 1 month
- 1440 (1d): max range 1 year
Response
Candlestick response
Example response
{
"candlesticks": [
[
[
{
"end_period_ts": 1727827200,
"open_interest": 8456498,
"price": {
"open": 0,
"high": 0,
"low": 0,
"close": 0,
"open_dollars": "0.0049",
"high_dollars": "0.0049",
"low_dollars": "0.0048",
"close_dollars": "0.0048",
"mean": 0,
"mean_dollars": "0.0049",
"previous": 0,
"previous_dollars": "0.0049"
},
"volume": 8456498,
"yes_ask": {
"open": 0.00489,
"close": 0.0048200000000000005,
"high": 0.00491,
"low": 0.0048,
"open_dollars": "0.0049",
"close_dollars": "0.0048",
"high_dollars": "0.0049",
"low_dollars": "0.0048"
},
"yes_bid": {
"open": 0.00489,
"close": 0.004829999990880811,
"high": 0.004910000000138527,
"low": 0.0048,
"open_dollars": "0.0049",
"close_dollars": "0.0048",
"high_dollars": "0.0049",
"low_dollars": "0.0048"
}
}
],
{
"token_id": "21742633143463906290569050155826241533067272736897614950488156847949938836455",
"side": "Yes"
}
]
]
}