Skip to main content
GET
/
series
/
{series_ticker}
/
events
/
{ticker}
/
forecast_percentile_history
Get Event Forecast Percentile History
curl --request GET \
  --url https://api.elections.kalshi.com/trade-api/v2/series/{series_ticker}/events/{ticker}/forecast_percentile_history \
  --header 'KALSHI-ACCESS-KEY: <api-key>' \
  --header 'KALSHI-ACCESS-SIGNATURE: <api-key>' \
  --header 'KALSHI-ACCESS-TIMESTAMP: <api-key>'
{
  "forecast_history": [
    {
      "event_ticker": "<string>",
      "end_period_ts": 123,
      "period_interval": 123,
      "percentile_points": [
        {
          "percentile": 123,
          "raw_numerical_forecast": 123,
          "numerical_forecast": 123,
          "formatted_forecast": "<string>"
        }
      ]
    }
  ]
}

Authorizations

KALSHI-ACCESS-KEY
string
header
required

Your API key ID

KALSHI-ACCESS-SIGNATURE
string
header
required

RSA-PSS signature of the request

KALSHI-ACCESS-TIMESTAMP
string
header
required

Request timestamp in milliseconds

Path Parameters

ticker
string
required

The event ticker

series_ticker
string
required

The series ticker

Query Parameters

percentiles
integer[]
required

Array of percentile values to retrieve (0-10000, max 10 values)

Maximum length: 10
start_ts
integer
required

Start timestamp for the range

end_ts
integer
required

End timestamp for the range

period_interval
enum<integer>
required

Specifies the length of each forecast period, in minutes. 0 for 5-second intervals, or 1, 60, or 1440 for minute-based intervals.

Available options:
0,
1,
60,
1440

Response

Event forecast percentile history retrieved successfully

forecast_history
object[]
required

Array of forecast percentile data points over time.

I