Skip to main content
GET
Get Kalshi Orderbook Summary

Request

Headers

string
required
Bearer token. Example: Bearer YOUR_API_KEY

Query Parameters

string
required
The Kalshi market ticker. Values are normalized to uppercase.
string
The UTC date to summarize, formatted as YYYY-MM-DD. Required unless start_timestamp and end_timestamp are provided.
integer
Inclusive lower timestamp bound in Unix seconds or milliseconds. Must be provided with end_timestamp.
integer
Inclusive upper timestamp bound in Unix seconds or milliseconds. Must be provided with start_timestamp.
integer
Time bucket resolution in seconds. Default: 60. Valid range: 1 to 3600.
Use date for a full UTC day, or use start_timestamp and end_timestamp for a custom UTC window. Custom windows hydrate book state from earlier records in the loaded UTC date partitions and emit buckets inside the requested range.

Response

string
The Kalshi market ticker.
string
The requested date.
integer
The bucket size used to build the summary.
integer
Number of summary points returned.
array
Array of time buckets. Each bucket includes close values and OHLC candles:
Kalshi records from 2026-03-31 through 2026-04-24 can have null price payloads for affected tickers. In that window, summaries can show quote_count without populated bid, ask, midpoint, or spread values. See Data Quality.

Example

Example response