Sign in

v1

latestOpenAPI 3.1.02026-07-2657157254.1 KB
polymarket

Get Candlesticks

Fetch historical candlestick data for a market.

Returns combined OHLCV data from both YES and NO tokens, normalized to YES perspective. NO token prices are converted as (1 - price) and volumes are combined.

get/v2/polymarket/candlesticks/{condition_id}

Path parameters

condition_idstring required

Condition ID for the market

Condition ID for the market

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

condition_idstring nullable

Market condition ID (set for condition-level candles)

token_idstring nullable

Outcome token ID (set for token-level candles)

first_trade_tsinteger nullable

Unix timestamp of the first trade

last_trade_tsinteger nullable

Unix timestamp of the last trade

intervalinteger required

Resolved candle interval in minutes (1, 5, 15, 60, or 1440). Reflects the auto-selected value when interval=0 is requested.

interval_secondsinteger required

Resolved candle interval in seconds — the bucket width of each candlestick