Skip to main content

​
Overview

Best bid and ask price and size for each market at every tick. Each row represents the top-of-book state at the time of capture. Available as both CSV (gzip-compressed) and Parquet (zstd-compressed).

​
Columns

Column
CSV typeParquet typeDescription
exchangestringstringAlways kalshi
tickerstringstringMarket ticker
local_timestampintegerint64Capture timestamp (nanoseconds since epoch)
exchange_timestampstringtimestamp_micros (nullable)Exchange timestamp (RFC 3339, microsecond precision)
bid_pricedecimalfloat64 (nullable)Best bid price
bid_sizedecimalfloat64 (nullable)Best bid size
ask_pricedecimalfloat64 (nullable)Best ask price
ask_sizedecimalfloat64 (nullable)Best ask size

​
Fetching Data

Use the path from the list response. The download endpoint returns a 302 redirect to a signed URL; follow it with curl -L or equivalent. 
import requests

def download_top_of_book(path, api_key):
    url = f"https://api.predictiondata.dev/v2/datasets{path}"
    headers = {"x-auth-token": api_key}

    response = requests.get(url, headers=headers, allow_redirects=True)
    response.raise_for_status()

    filename = path.split("/")[-1]
    with open(filename, "wb") as f:
        f.write(response.content)

    print(f"Downloaded to {filename}")

if __name__ == "__main__":
    api_key = "YOUR_API_KEY"
    path = "/kalshi/KXSB-26-NE/top-of-book/2026-02-03.csv.gz"

    download_top_of_book(path, api_key)

​
Notes

  • The orderbook is the YES orderbook. Bids are the raw YES bids from Kalshi. Asks are calculated by taking 1 - price of the NO bids. If you need the raw, unconverted data, contact calder@predictiondata.dev.
  • Prices and quantities are rounded to 4 decimal places.
  • local_timestamp is nanoseconds since Unix epoch (when our servers captured the message).
  • exchange_timestamp is when the event occurred on Kalshi. In CSV it is an RFC 3339 string; in Parquet it is stored as TimestampMicros.
  • Each export covers one UTC day (00:00:00 to 23:59:59).