/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).