Kalshi Historical Orderbook Snapshots | BlockRun

Market and period

Provide the exact Kalshi market ticker, plus start and end times with a time zone. An event or series ticker is not the market identifier this request needs. The Agent converts both times to integer Unix milliseconds and sends ticker, start_time and end_time directly inside queryParams, not queryParams.query. Choose an end later than the start. Optional limit accepts an integer from 1 to 2,000; the supplier default is 100. A page limit does not guarantee a record count.

The supplier reports that this history begins on January 7, 2026, without specifying the exact cutoff instant. That date does not guarantee records for every market or period. Empty or partial results cannot establish that no orders existed, and a page cannot prove continuous coverage. This is a historical query, rather than a stream of current book changes.

Reading available snapshot records

The supplier describes each available snapshot with its market ticker and timestamp in milliseconds. yes_bids lists Yes-side bid price levels in descending price order; yes_asks lists Yes-side ask levels in ascending price order. Each level has a price in whole cents and size in contracts. Supplier documentation lists prices of 1–99 cents, but returned boundary prices can include 0 and 100; preserve them unchanged. For example, a returned price value of 50 means 50 cents ($0.50). Keep the unit explicit.

best_bid and best_ask are prices in cents. bid_depth and ask_depth are total bid-side and ask-side contract quantities, not dollar amounts or executed trade volume. sequence orders records that share a timestamp; it does not establish a globally unique or gap-free sequence. Read snapshots as orderbook observations rather than completed trades or guaranteed fills. Depth is supplier-reported and may differ from the sum of displayed level sizes; preserve it without replacing it with a recalculated total.

Whole-cent precision and availability

This endpoint rounds sub-cent prices to whole cents. The supplier says that rounding widens spreads and merges neighboring price levels, so the snapshots cannot reconstruct the original sub-cent prices or exact native book spread. Preserve returned levels and quantities rather than guessing the finer prices.

The supplier has announced that this endpoint will be deprecated, but has not supplied a cutoff date on this page. Its recommended sub-cent endpoint is a different capability; this Tool does not silently switch to it. Check current Tool availability before requesting the history.

Sources and connection

Predexon Kalshi orderbook-history documentation defines the timestamps, prices, quantities and rounding limitation. The matching BlockRun operation provides this Tool's route. Connect your Agent to Toolmu and provide the market and period you want to inspect.