Skip to main content
GET
/
historical
/
kalshi
/
top-of-book
Historical top of book
curl --request GET \
  --url https://api.oddpool.com/historical/kalshi/top-of-book
Lightweight timeseries of best bid, best ask, mid, and spread. Same data as the orderbook endpoint but without the full level arrays. Ideal for charting price history.

​
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/top-of-book?market_id=KXFEDDECISION-26APR-H0&start_time=1774015200000&end_time=1774018800000&granularity=5m"

​
Response

{
  "snapshots": [
    {
      "market_id": "KXFEDDECISION-26APR-H0",
      "timestamp": 1774015256106,
      "best_yes_bid": 0.94,
      "best_yes_ask": 0.94,
      "mid": 0.94,
      "spread": 0.0
    }
  ],
  "pagination": { ... }
}
best_yes_bid and best_yes_ask are null when the book had no resting orders at sample time. Filter client-side if you only want quoted snapshots.