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 market API

The market API from Kalshi — 9 operation(s) for market.

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

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

This API exposes 9 operations across 9 paths, and defines 27 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.

9 operations 9 paths 27 schemas 9 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 market 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 9

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

market 9
GET
/series/{series_ticker}/markets/{ticker}/candlesticks
Get Market Candlesticks
GetMarketCandlesticks 6 params → 200400404500
GET
/markets/trades
Get Trades
GetTrades 5 params → 200400500
GET
/markets/{ticker}/orderbook
Get Market Orderbook
GetMarketOrderbook 2 params → 200401404500
GET
/markets/orderbooks
Get Multiple Market Orderbooks
GetMarketOrderbooks 1 param → 200400401500
GET
/series/{series_ticker}
Get Series
GetSeries 2 params → 200400500
GET
/series
Get Series List
GetSeriesList 5 params → 200400500
GET
/markets
Get Markets
GetMarkets 14 params → 200400401500
GET
/markets/{ticker}
Get Market
GetMarket 1 param → 200401404500
GET
/markets/candlesticks
Batch Get Market Candlesticks
BatchGetMarketCandlesticks 5 params → 200400401500

Schemas 27

The contract defines 27 schemas that model the data the API accepts and returns. The most detailed are Market (55 properties), Series (14 properties), Trade (9 properties), PriceDistribution (8 properties). Each schema is shown below with its type and property counts.

MarketCandlesticksResponse
object
2 properties 2 required
GetMarketCandlesticksResponse
object
2 properties 2 required
PriceRange
object
3 properties 3 required
Trade
object
9 properties 9 required
GetMarketsResponse
object
2 properties 2 required
MarketCandlestick
object
6 properties 6 required
BidAskDistribution
object
4 properties 4 required
ExchangeIndex
integer
Identifier for an exchange shard. Defaults to 0 if unspecified. Note: currently only 0 supported.
MarketOrderbookFp
object
2 properties 2 required
ErrorResponse
object
4 properties
PriceDistribution
object
8 properties
GetTradesResponse
object
2 properties 2 required
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.…
PriceLevelDollarsCountFp
array
Price level in dollars represented as [dollarsstring, fp] where dollarsstring is like "0.1500" and fp is a FixedPointCount string (fixed-point contract count).…
BookSide
string
Side of the book for an order or trade. For event markets, this refers to the YES leg only: bid means buy YES, ask means sell YES. (Selling YES is economically…
GetSeriesResponse
object
1 property 1 required
GetSeriesListResponse
object
1 property 1 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…
GetMarketOrderbooksResponse
object
1 property 1 required
SettlementSource
object
2 properties
GetMarketOrderbookResponse
object
1 property 1 required
BatchGetMarketCandlesticksResponse
object
1 property 1 required
GetMarketResponse
object
1 property 1 required
MveSelectedLeg
object
4 properties
Series
object
14 properties 11 required
OrderbookCountFp
object
Orderbook with fixed-point contract counts (fp) in all dollar price levels.
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

kalshi-market-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 events API
Kalshi exchange API
Kalshi fcm API
Kalshi historical API
Kalshi incentive-programs API