Skip to main content
GET
Get Candlesticks By Token
Fetch OHLCV candlestick data for one specific outcome token. Unlike the condition-level candlesticks endpoint, prices are not normalized - 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.
Free & Unlimited. This endpoint does not count toward your monthly usage limits on any plan.
Use this when you need to chart each side of a binary market separately, or when working with a specific token ID rather than a condition ID.

Intervals

The response includes first_trade_ts and last_trade_ts - the Unix timestamps of the first and last trades for this token. 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

token_id
string
required

Outcome token ID

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