---
title: "Get Kalshi Orderbooks"
method: GET
path: "/v2/kalshi/orderbooks"
tags: ["kalshi"]
---

# Get Kalshi Orderbooks

`GET /v2/kalshi/orderbooks`

Fetch historical orderbook snapshots for a Kalshi market over a specified time range.

Returns snapshots of the order book including yes bids, yes asks, and market metadata.
All timestamps are in milliseconds. Prices are in cents (1-99 representing $0.01 to $0.99).

## Query parameters

- `ticker` string, required — The Kalshi market ticker
- `start_time` integer, required — Start time in Unix timestamp (milliseconds)
- `end_time` integer, required — End time in Unix timestamp (milliseconds)
- `limit` integer — Maximum number of snapshots to return
- `pagination_key` string, nullable — Pagination key to get the next chunk of data

## Response `200`

Successful Response

- KalshiOrderbooksResponse — Kalshi orderbooks endpoint response.
  - `snapshots` KalshiOrderbookSnapshot[], required
    - `ticker` string, required — Market ticker
    - `timestamp` integer, required — Snapshot timestamp in milliseconds
    - `yes_bids` KalshiOrderbookLevel[], required — Yes bid levels, ordered by price descending
      - `price` integer, required — Price in cents (1-99)
      - `size` integer, required — Number of contracts at this price level
    - `yes_asks` KalshiOrderbookLevel[], required — Yes ask levels, ordered by price ascending
      - `price` integer, required — Price in cents (1-99)
      - `size` integer, required — Number of contracts at this price level
    - `best_bid` integer, required — Best bid price in cents
    - `best_ask` integer, required — Best ask price in cents
    - `bid_depth` integer, required — Total bid depth (number of contracts)
    - `ask_depth` integer, required — Total ask depth (number of contracts)
    - `sequence` integer, required — Sequence number for ordering within same timestamp
  - `pagination` CursorPagination, required — Cursor-based pagination for endpoints that don't support offset.
    - `limit` integer, required — Requested limit
    - `count` integer, required — Number of items in current response
    - `pagination_key` string, nullable — Base64-encoded cursor for next page
    - `has_more` boolean, required — Whether there are more items available

## Other responses

- `400` — Bad Request
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/predexon/apis/predexon-api.md) · [All operations](https://skmtc.net/predexon/apis/predexon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/predexon/predexon-api/revisions/80a306fbdb39/schema)