Price History
Historical OHLC price data normalized by Prediction.com across supported markets. Kalshi candles use Kalshi's native trade history. Candles for other platforms are built from our order book capture: prices track the YES midpoint and volume fields are null.
/v2/prices/historyParameters
platformstringrequiredPlatform identifier (required).
market_idstringrequiredPlatform-native market ID (required). For Kalshi, use the full market-level ticker from the catalog's ticker field (for example KXBTC15M-26AUG190815-15), not event_ticker.
fromstringStart timestamp (ISO 8601). Default: 7 days ago.
tostringEnd timestamp (ISO 8601). Default: now.
intervalstringCandle size: 1m | 5m | 15m | 1h | 1d. Default: 1h. Kalshi 5m and 15m candles are aggregated from its native 1m candles. For other platforms, 15m candles are aggregated from 5m candles. A range that would return too many candles gets a 400 validation.range_too_large response.
Response
market_idstringPlatform-native market ID.
platformstringPlatform identifier.
intervalstringCandle interval used.
candlesobject[]OHLC candle data ordered by timestamp ascending.
Show 10 fields
timestampstringCandle start time (ISO 8601).
opennumberOpening price of the interval, in cents. Kalshi: traded price. Other platforms: YES midpoint.
highnumberHighest price during the interval, on the same basis as open.
lownumberLowest price during the interval, on the same basis as open.
closenumberClosing price of the interval, on the same basis as open.
yes_bidnumberLast YES bid price in the interval.
yes_asknumberLast YES ask price in the interval.
midnumberMidpoint of yes_bid and yes_ask at close. Falls back to close for a settled/empty book (bid 0 / ask 100) instead of reporting 50.
volumenumber | nullContracts traded during the interval. Kalshi history preserves Kalshi's fixed-point bucket volume. Null for other platforms.
dollar_volumenumber | nullDollar volume traded during the interval. Null for platforms other than Kalshi.
_metaobjectData provenance and availability details for Kalshi requests.
Show 3 fields
sourcestringData source (kalshi).
data_tierstringKalshi tier used: live, historical, or unavailable.
messagestringTroubleshooting guidance when data_tier is unavailable.