Skip to main content
GET
/
historical
/
kalshi
/
orderbook
Historical orderbook
curl --request GET \
  --url https://api.oddpool.com/historical/kalshi/orderbook
Full orderbook snapshots with YES bids, NO bids, and derived best bid/ask from the YES perspective. Without start_time/end_time, returns the most recent snapshots.

​
Parameters

​
market_id
string
required
Kalshi market ticker (e.g., KXFEDDECISION-26APR-H0).
​
start_time
integer
Start time in Unix ms. Omit with end_time to get latest data.
​
end_time
integer
End time in Unix ms. Omit with start_time to get latest data.
​
granularity
string
default:"1m"
Snapshot interval: 1m or 5m.
​
limit
integer
default:"100"
Max rows per page (1-200).
​
pagination_key
string
Cursor from previous response for next page.

​
Example

curl -H "X-API-Key: oddpool_..." \
  "https://api.oddpool.com/historical/kalshi/orderbook?market_id=KXFEDDECISION-26APR-H0&start_time=1774015200000&end_time=1774018800000&limit=5"

​
Response

{
  "snapshots": [
    {
      "market_id": "KXFEDDECISION-26APR-H0",
      "timestamp": 1774015256106,
      "yes_bids": [
        {"price": "0.9400", "size": 12500.0},
        {"price": "0.9300", "size": 8000.0}
      ],
      "no_bids": [
        {"price": "0.0600", "size": 21.0},
        {"price": "0.0500", "size": 366630.0}
      ],
      "best_yes_bid": 0.94,
      "best_yes_ask": 0.94,
      "mid": 0.94,
      "spread": 0.0
    }
  ],
  "pagination": {
    "limit": 5,
    "count": 5,
    "has_more": true,
    "pagination_key": "eyJo..."
  }
}