---
title: "Get Kalshi Orderbook History"
method: GET
path: "/kalshi/orderbooks"
---

# Get Kalshi Orderbook History

`GET /kalshi/orderbooks`

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.

## Query parameters

- `ticker` string, required
- `start_time` integer
- `end_time` integer
- `limit` integer
- `paginationKey` string

## Response `200`

Kalshi orderbook history response

- object
  - `snapshots` object[] — Array of orderbook snapshots at different points in time
    - `orderbook` object
      - `yes` array[] — Yes side orders with prices in cents
        - number[] — [price_in_cents, contract_count]
      - `no` array[] — No side orders with prices in cents
        - number[] — [price_in_cents, contract_count]
      - `yes_dollars` array[] — Yes side orders with prices in dollars
        - union[] — [price_as_dollar_string, contract_count]
          - union
            - string
            - number
      - `no_dollars` array[] — No side orders with prices in dollars
        - union[] — [price_as_dollar_string, contract_count]
          - union
            - string
            - number
    - `timestamp` integer — Timestamp of the snapshot in milliseconds
    - `ticker` string — The Kalshi market ticker
  - `pagination` object
    - `limit` integer
    - `count` integer — Number of snapshots returned
    - `paginationKey` string — Base64-encoded cursor for fetching the next page of results. Only present when has_more is true.
    - `has_more` boolean — Whether there are more snapshots available

## Other responses

- `400` — Bad Request - Invalid parameters

---

[API](https://skmtc.net/domeapi/apis/dome-api.md) · [All operations](https://skmtc.net/domeapi/apis/dome-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/domeapi/dome-api/versions/7c5d22727cce/schema)