Sign in

v1

latestOpenAPI 3.0.32026-07-2618063.1 KB

Get Kalshi Orderbook History

Fetches historical orderbook snapshots for a specific Kalshi market (ticker) over a specified time range. If no start_time and end_time are provided, returns the latest orderbook snapshot for the market. Returns snapshots of the order book including yes/no bids and asks with prices in both cents and dollars. All timestamps are in milliseconds. Orderbook data has history starting from October 29th, 2025. Note: When fetching the latest orderbook (without start/end times), the limit parameter is ignored.

get/kalshi/orderbooks

Query parameters

tickerstring required
Example:KXNFLGAME-25AUG16ARIDEN-ARI

The Kalshi market ticker

start_timeinteger
Example:1760470000000

Start time in Unix timestamp (milliseconds). Optional - if not provided along with end_time, returns the latest orderbook snapshot.

end_timeinteger
Example:1760480000000

End time in Unix timestamp (milliseconds). Optional - if not provided along with start_time, returns the latest orderbook snapshot.

limitinteger
Example:100

Maximum number of snapshots to return (default: 100, max: 200). Ignored when fetching the latest orderbook without start_time and end_time.

paginationKeystring
Example:eyJ0aW1lc3RhbXAiOjE3NjA0NzAwMDAwMDAsInRpY2tlciI6IktYTkZMR0FNRS0yNUFVRzE2QVJJREVOLUFSSSIsInRvdGFsIjoxMDB9

Base64-encoded cursor for efficient pagination. Returned in the previous response's pagination object.

Response

Kalshi orderbook history response

Example response

{
  "snapshots": [
    {
      "orderbook": {
        "yes": [
          [
            75,
            100
          ]
        ],
        "no": [
          [
            25,
            100
          ]
        ],
        "yes_dollars": [
          [
            "0.75",
            100
          ]
        ],
        "no_dollars": [
          [
            "0.25",
            100
          ]
        ]
      },
      "timestamp": 1760471849407,
      "ticker": "KXNFLGAME-25AUG16ARIDEN-ARI"
    }
  ],
  "pagination": {
    "limit": 100,
    "count": 4,
    "paginationKey": "eyJ0aW1lc3RhbXAiOjE3NjA0NzAwMDAwMDAsInRpY2tlciI6IktYTkZMR0FNRS0yNUFVRzE2QVJJREVOLUFSSSIsInRvdGFsIjoxMDB9"
  }
}