---
title: "Kalshi Orderbook History"
method: GET
path: "/gateway/v1/prediction-market/kalshi/orderbooks"
tags: ["Prediction Market"]
---

# Kalshi Orderbook History

`GET /gateway/v1/prediction-market/kalshi/orderbooks`

## Request

- Base URL: `https://api.asksurf.ai`
- URL: `https://api.asksurf.ai/gateway/v1/prediction-market/kalshi/orderbooks`
- Auth: HTTP bearer

Historical orderbook snapshots for a Kalshi market. Returns yes-side bid/ask levels. Timestamps in milliseconds, prices in cents.

Data refresh: ~5 minutes

## Query parameters

- `ticker` string, required: Kalshi market ticker
- `start_time` integer: Start time in Unix milliseconds. 0 means 7 days ago.
- `end_time` integer: End time in Unix milliseconds. 0 means current time.
- `limit` integer: Maximum number of snapshots to return
- `pagination_key` string: Base64 cursor for pagination

## Response `200`

OK

- V2KalshiOrderbooksResponse
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `pagination` V2CursorPagination, required
    - `count` integer, required: Items in current response
    - `has_more` boolean, required: Whether more data is available
    - `limit` integer, required: Requested limit
    - `pagination_key` string: Base64 cursor for next page
  - `snapshots` V2KalshiOrderbookSnapshot[], nullable, required
    - `ask_depth` integer, required: Total ask depth (contracts)
    - `best_ask` integer, required: Best ask price (cents)
    - `best_bid` integer, required: Best bid price (cents)
    - `bid_depth` integer, required: Total bid depth (contracts)
    - `sequence` integer, required: Sequence number
    - `ticker` string, required: Market ticker
    - `timestamp` integer, required: Snapshot time in milliseconds
    - `yes_asks` V2KalshiOrderbookLevel[], nullable, required: Yes sell orders, price ascending
      - `price` integer, required: Price in cents (1-99)
      - `size` integer, required: Number of contracts at this price level
    - `yes_bids` V2KalshiOrderbookLevel[], nullable, required: Yes buy orders, price descending
      - `price` integer, required: Price in cents (1-99)
      - `size` integer, required: Number of contracts at this price level

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api.md) - [All operations](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api/revisions/91774fdd5302?raw)