Skip to main content
List exports by ticker, then download using the path from each export object. Both CSV (gzip-compressed) and Parquet (zstd-compressed) files are available for every export type.

​
Base URL

https://api.predictiondata.dev/v2

​
Authentication

Send your API key in the x-auth-token header. Your key’s tier must allow access to the exchange (e.g. a kalshi tier for Kalshi). The admin and all tiers can access any exchange. 
curl -H "x-auth-token: YOUR_API_KEY" \
  "https://api.predictiondata.dev/v2/exports/kalshi/tickers/KXSB-26-NE"

​
Finding exports for a ticker

List all exports for a given ticker: 
GET /v2/exports/kalshi/tickers/{ticker}
Example: New England to win the Super Bowl — ticker KXSB-26-NE. (You can find tickers on Kalshi’s site or from the list response when querying by event.) 
curl -H "x-auth-token: YOUR_API_KEY" \
  "https://api.predictiondata.dev/v2/exports/kalshi/tickers/KXSB-26-NE"

​
Response format

The endpoint returns an array of export objects. Each object includes:
FieldDescription
pathPath to use when downloading (see below)
dayDate of the export (UTC)
exportTypetop_of_book, top_5, top_25, complete, or trades
fileFormatCSV or PARQUET
fileSizeBytesSize of the file
tickerMarket ticker

​
Export types

Export typeDescriptionFile formats
top_of_bookBest bid/ask onlyCSV (gzip), Parquet (zstd)
top_5Top 5 price levelsCSV (gzip), Parquet (zstd)
top_25Top 25 price levelsCSV (gzip), Parquet (zstd)
completeFull orderbook event streamCSV (gzip), Parquet (zstd)
tradesTrade executionsCSV (gzip), Parquet (zstd)

​
Downloading an export

Use the path from an export object: 
GET /v2/datasets/{path}
The server responds with a 302 redirect to a signed CloudFront URL. The URL is valid for 5 minutes. Follow redirects (e.g. curl -L) to download the file. Example: If the list response contains "path": "/kalshi/KXSB-26-NE/top-of-book/2026-02-03.csv.gz": 
curl -L -H "x-auth-token: YOUR_API_KEY" \
  "https://api.predictiondata.dev/v2/datasets/kalshi/KXSB-26-NE/top-of-book/2026-02-03.csv.gz" \
  --output data.csv.gz

​
Quick reference

StepEndpointAuth
List by tickerGET /v2/exports/kalshi/tickers/{ticker}x-auth-token
DownloadGET /v2/datasets/{path}x-auth-token (302 → signed URL)
Need a key or a different exchange? Contact calder@predictiondata.dev.