Sign in

v1

latestOpenAPI 3.1.02026-07-243035381.4 MB
Prediction API

Get market price history

/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).
get/v4/data/prediction/markets/{id}/history

Path parameters

idstring required
Example:0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917

Platform-native market identifier.

Query parameters

interval'1m' | '5m' | '15m' | '1h' | '4h' | '1d' | '1w' required

OHLC candle bucket size. Each interval has its own maximum allowed time window; requests exceeding that window return 400.

Example:1h

Candle bucket size.

startstring date-time required
Example:2026-05-01T00:00:00Z

Window start (ISO-8601). Must be earlier than end.

endstring date-time required
Example:2026-05-15T00:00:00Z

Window end (ISO-8601). Must be later than start.

source'candlesticks' | 'midpoint'

Underlying data feed for OHLC candles. candlesticks (default) is trade-based with real in-bucket volume. midpoint uses a midpoint-quote feed with broader time-range coverage at the cost of volume = 0 on every candle. midpoint is Polymarket-only.

Example:candlesticks

Data source. Defaults to candlesticks. midpoint is Polymarket-only.

Response

OK

Example response

{
  "data": {
    "marketId": "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917",
    "platform": "polymarket",
    "interval": "1h",
    "source": "candlesticks",
    "candles": [
      {
        "timestamp": "2026-05-18T12:00:00Z",
        "open": 0.41,
        "high": 0.44,
        "low": 0.4,
        "close": 0.43,
        "volume": 12450.5
      }
    ],
    "availableFrom": "2026-05-01T00:00:00Z"
  }
}