Polymarket Endpoints
Polymarket Candlesticks API
Candlesticks return historical probability price points at configurable candle width, proxied from clob.polymarket.com.
Get Polymarket candlesticks
Historical probability price series for a Polymarket market at configurable candle width, proxied from clob.polymarket.com.
Live GET Request
Try it
Live Response
Click Try It to run this GET request against the API.Request
curl 'https://api.thepredictionmarkets.com/api/v2/polymarket/candlesticks?market_slug=2026-nba-champion&fidelity=60' \
-H 'X-API-Key: YOUR_TPM_API_KEY'Response
{
"history": [
{ "t": 1745280000, "p": 0.481 },
{ "t": 1745283600, "p": 0.490 },
{ "t": 1745287200, "p": 0.495 }
],
"market_slug": "2026-nba-champion",
"condition_id": "0x123...",
"fidelity_minutes": 60
}Query Parameters
| Name | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| market_slug | string | No | - | 2026-nba-champion | Polymarket market or event slug. Required unless condition_id is provided. |
| condition_id | string | No | - | 0xabc123 | Polymarket condition ID. Overrides market_slug. |
| fidelity | integer | No | 60 | 60 | Candle width in minutes. Common values: 1, 5, 60, 1440. |
| start_ts | integer | No | - | 1745280000 | Start of range as Unix timestamp (seconds). |
| end_ts | integer | No | - | 1745366400 | End of range as Unix timestamp (seconds). |
Response Fields
| Field | Type | Example | Description |
|---|---|---|---|
| history | object[] | - | Array of candle points. |
| history.t | integer | - | Candle open time as Unix timestamp (seconds). |
| history.p | number | - | Probability/price at candle open (0 to 1). |
| fidelity_minutes | integer | - | Candle width used for this response. |
Build with TPM
Get your API key
Start with Kalshi and Polymarket market data, then add unified spreads, signals, alerts, and watchlists as your workflow grows.