Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Kalshi events API

Event endpoints

Kalshi events API is one of 21 APIs that Kalshi publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include events. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 6 operations across 6 paths, and defines 21 schemas. It is described by OpenAPI 3.0.0, at version 3.19.0.

Requests are made against 4 base URLs: https://external-api.kalshi.com/trade-api/v2, https://api.elections.kalshi.com/trade-api/v2, https://external-api.demo.kalshi.co/trade-api/v2, https://demo-api.kalshi.co/trade-api/v2.

6 operations 6 paths 21 schemas 6 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
3.19.0
Base URL
https://api.elections.kalshi.com/trade-api/v2
Authentication
API Key, API Key, API Key
Resource Areas
1

Authentication & Security 3

Kalshi events API declares 3 security schemes for authenticating requests. An API key is passed in the header as KALSHI-ACCESS-KEY (kalshiAccessKey). An API key is passed in the header as KALSHI-ACCESS-SIGNATURE (kalshiAccessSignature). An API key is passed in the header as KALSHI-ACCESS-TIMESTAMP (kalshiAccessTimestamp).

  • kalshiAccessKey — Your API key ID
  • kalshiAccessSignature — RSA-PSS signature of the request
  • kalshiAccessTimestamp — Request timestamp in milliseconds

Paths & Operations 6

Across 6 paths, the API surfaces 6 operations — 6 GET. Each is listed below with its method, path, parameters, and response codes.

events 6

Event endpoints

GET
/series/{series_ticker}/events/{ticker}/candlesticks
Get Event Candlesticks
GetMarketCandlesticksByEvent 5 params → 200400401500
GET
/events
Get Events
GetEvents 8 params → 200400401500
GET
/events/multivariate
Get Multivariate Events
GetMultivariateEvents 5 params → 200400401500
GET
/events/{event_ticker}
Get Event
GetEvent 2 params → 200400404401500
GET
/events/{event_ticker}/metadata
Get Event Metadata
GetEventMetadata 1 param → 200400404401500
GET
/series/{series_ticker}/events/{ticker}/forecast_percentile_history
Get Event Forecast Percentile History
GetEventForecastPercentilesHistory 6 params → 200400401500

Schemas 21

The contract defines 21 schemas that model the data the API accepts and returns. The most detailed are Market (55 properties), EventData (16 properties), Milestone (13 properties), PriceDistribution (8 properties). Each schema is shown below with its type and property counts.

EventData
object
16 properties 8 required
PriceRange
object
3 properties 3 required
GetEventMetadataResponse
object
6 properties 3 required
GetEventCandlesticksResponse
object
3 properties 3 required
GetEventForecastPercentilesHistoryResponse
object
1 property 1 required
GetEventResponse
object
2 properties 2 required
MarketCandlestick
object
6 properties 6 required
Milestone
object
13 properties 10 required
BidAskDistribution
object
4 properties 4 required
ExchangeIndex
integer
Identifier for an exchange shard. Defaults to 0 if unspecified. Note: currently only 0 supported.
PercentilePoint
object
4 properties 4 required
PriceDistribution
object
8 properties
Market
object
55 properties 35 required
FixedPointCount
string
Fixed-point contract count string (2 decimals, e.g., "10.00"; referred to as "fp" in field names). Requests accept 0–2 decimal places (e.g., "10", "10.0", "10.…
GetEventsResponse
object
3 properties 2 required
GetMultivariateEventsResponse
object
2 properties 2 required
ForecastPercentilesPoint
object
4 properties 4 required
FixedPointDollars
string
US dollar amount as a fixed-point decimal string with up to 6 decimal places of precision. This is the maximum supported precision; valid quote intervals for a…
SettlementSource
object
2 properties
MarketMetadata
object
3 properties 3 required
MveSelectedLeg
object
4 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

kalshi-events-api-openapi.yml Raw ↑

Other APIs Kalshi publishes across the network.

Kalshi Trade API (Demo)
Kalshi WebSocket Streaming API
Kalshi AsyncAPI Specification
Kalshi Python Starter Kit
Kalshi account API
Kalshi api-keys API
Kalshi communications API
Kalshi exchange API
Kalshi fcm API
Kalshi historical API
Kalshi incentive-programs API
Kalshi live-data API