/v4/data/prediction/markets/{id}/history

200 credits per API call

Historical OHLC price candles for a market over a time window. Used to power chart views — every candle includes open / high / low / close prices plus the in-bucket trade volume.

Filtering

• interval is required. Accepted values: 1m, 5m, 15m, 1h, 4h, 1d, 1w. Each interval has a maximum allowed range (e.g. 1m can be queried for ~1 day at a time, 1d for ~1 year). Requests exceeding the range cap return 400.
• start and end are required ISO-8601 timestamps. end must be after start.
• source selects the underlying data feed. Defaults to candlesticks (trade-based OHLC with real volume). Pass midpoint to switch to a midpoint-quote feed with broader range coverage at the cost of volume = 0 on every candle. source=midpoint is supported on Polymarket only — passing it against a Kalshi market returns 400.

Other notes

• partial: true indicates the requested range was truncated by an upstream availability limit. This only happens on Polymarket with source=candlesticks (the trade-based feed exposes a finite window of historical fills); Kalshi candles cover the full requested range, and source=midpoint on Polymarket also covers the full range.
• When partial is true, availableFrom contains the earliest timestamp the response actually covers — data before that point is unavailable from the trade-based feed. To recover the missing range on Polymarket, repeat the call with source=midpoint; the response spans the full window at the cost of volume = 0 on every candle (the midpoint feed carries quotes, not fills).
• availableFrom is null when no trades exist in the entire requested range.
• Candle timestamps are bucket-aligned (e.g. an interval=1h response has timestamps on the hour).