Skip to main content
GET
Get Candlesticks
Fetch OHLCV candlestick data for charting. Prices normalized to YES side (NO prices converted as 1 - price).
Free & Unlimited. This endpoint does not count toward your monthly usage limits on any plan.

Intervals

The response includes first_trade_ts and last_trade_ts - the Unix timestamps of the first and last trades in the market, useful for determining the full available data range. It also echoes back the resolved interval (in minutes) and interval_seconds (bucket width), so you know which bucket size was picked when requesting interval=0.

Authorizations

x-api-key
string
header
required

Path Parameters

condition_id
string
required

Condition ID for the market

Query Parameters

start_time
integer | null

Unix timestamp (seconds) for start of time range

Required range: x >= 0
end_time
integer | null

Unix timestamp (seconds) for end of time range

Required range: x >= 0
interval
integer
default:0

Interval: 0=auto, 1=1m, 5=5m, 15=15m, 60=1h, 1440=1d

Response

Successful Response

Candlesticks endpoint response.

interval
integer
required

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

interval_seconds
integer
required

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

candlesticks
CandlestickData · object[]
required

Array of candlestick data points

condition_id
string | null

Market condition ID (set for condition-level candles)

token_id
string | null

Outcome token ID (set for token-level candles)

first_trade_ts
integer | null

Unix timestamp of the first trade

last_trade_ts
integer | null

Unix timestamp of the last trade