Dati API Kalshi
Dati API Kalshi: Mercati, Order Book, Candele e Operazioni
L'API pubblica di Kalshi restituisce serie, eventi, mercati, l'order book corrente, candele e operazioni, e nessuna di queste chiamate richiede una chiave API. Ciò che non restituisce è l'order book in un momento passato. Questa pagina mappa ogni tipo di dato Kalshi al suo endpoint, mostra le chiamate e copre il gap con 1.5 miliardi di libri registrati.
I dati API Kalshi sono i dati di borsa forniti dall'API Trade di Kalshi a https://external-api.kalshi.com/trade-api/v2. I dati di mercato pubblici coprono serie, eventi, mercati, l'order book corrente, candele e operazioni; i dati liquidati più vecchi di una soglia pubblicata si spostano agli endpoint /historical. I dati account (ordini, riempimenti, posizioni) richiedono richieste API-key firmate RSA.
Sfoglia i file giornalieri Kalshi
Un libro ordini Kalshi, come registrato
Copiato da un'osservazione BTC 15-min archiviata in DepthFeed. La risposta del libro d'ordine Kalshi riporta le stesse due scale di offerta per il momento corrente.
Un bid sì al prezzo p è un'offerta no a 1 − p, quindi l'ask sì implicito è 1 − il miglior bid no.: poll REST a profondità completa.
- yes_dollars / yes_prices
- Yes bid in attesa come prezzo e conteggio contratti, migliori per primi.
- no_dollars / no_prices
- No bid in attesa. Ognuno è un'offerta yes a 1 − prezzo, che dà la yes ask implicita (0.33 qui).
- ticker
- Il ticker esatto del mercato, strike incluso.
- recv_ts_ms
- Tempo di ricezione di DepthFeed in millisecondi epoch; la risposta libro di Kalshi non ha timestamp di scambio.
Dati API Kalshi a colpo d'occhio
- URL base
- https://external-api.kalshi.com/trade-api/v2
- Autenticazione dati di mercato
- Nessuno per serie, eventi, mercati, libro ordini, candele e scambi
- Autenticazione dati account
- Header API-key firmati RSA
- Libro ordini
- Scale di offerta sì e no correnti; ask = 1 − miglior bid opposto
- Periodi candlestick
- 1 minuto · 1 ora · 1 giorno
- Dati risolti più vecchi
- Endpoint /historical dopo la data limite pubblicata
- Libri d'ordine passati
- Non servito da Kalshi; DepthFeed li registra da 2026-01-08
Recupera dati API Kalshi con curl
Ogni chiamata qui sotto è pubblica. Sostituisci i ticker con quelli della prima risposta; i timestamp sono secondi Unix.
# Open markets in one series
curl -s "https://external-api.kalshi.com/trade-api/v2/markets?series_ticker=KXBTC15M&status=open&limit=5"
# The current order book for one exact market
curl -s "https://external-api.kalshi.com/trade-api/v2/markets/<market_ticker>/orderbook"
# Hourly candles for that market
curl -s "https://external-api.kalshi.com/trade-api/v2/series/KXBTC15M/markets/<market_ticker>/candlesticks?start_ts=1793232000&end_ts=1793318400&period_interval=60"
# Recent trades, then the cutoff for older ones
curl -s "https://external-api.kalshi.com/trade-api/v2/markets/trades?ticker=<market_ticker>&limit=100"
curl -s "https://external-api.kalshi.com/trade-api/v2/historical/cutoff"- Segui il campo cursore finché non torna vuoto.
- Leggi la yes ask come 1 − miglior no bid; il libro ordini non ha array ask.
- Mercati risolti prima del cutoff sono solo sugli endpoint /historical.
Dati API Kalshi
Cosa restituisce l'API Kalshi e da dove
Serie, eventi e mercati: la gerarchia
Una serie è una domanda ricorrente (KXBTC15M è Bitcoin ogni 15 minuti), un evento è una sua istanza, e un mercato è un contratto sì/no negoziabile all'interno dell'evento, con il suo strike nel ticker. GET /series/{series_ticker}, GET /events/{event_ticker} e GET /markets?series_ticker=… li restituiscono. Usa il ticker completo del mercato come chiave di join: un ticker di evento nomina diversi mercati con prezzi molto diversi.
Dati di mercato senza chiave API
Kalshi documenta i suoi endpoint dati di mercato come pubblici: non servono header API-key per serie, eventi, mercati, orderbook, candele o operazioni. L'URL base di produzione è https://external-api.kalshi.com/trade-api/v2; il più vecchio host api.elections.kalshi.com serve gli stessi mercati, non solo elezioni. Le chiavi sono necessarie per il lato account (ordini, riempimenti, posizioni) e per il feed WebSocket.
Il libro d'ordine: solo offerte, e solo correnti
GET /markets/{ticker}/orderbook restituisce due scale di bid, sì e no, come prezzi in dollari con conteggi di contratti (orderbook_fp.yes_dollars e no_dollars). Non esiste un array ask: un bid no a p è un’offerta sì a 1 − p, quindi nel campione registrato in questa pagina il miglior bid sì è 0.32, il miglior bid no 0.67 e l’ask sì implicito 0.33. La risposta è il libro ora; richiamarlo dopo non indica com’era.
Candlestick: 1 minuto, orario o giornaliero
GET /series/{series_ticker}/markets/{ticker}/candlesticks accetta start_ts, end_ts e period_interval di 1, 60 o 1440 minuti. Ogni candela riporta open, high, low e close per il bid sì, l’ask sì e il prezzo scambiato, più volume e open interest. È il modo più economico per tracciare un mercato, ma registra cosa è stato scambiato e dove ha chiuso il top of book, non quanta dimensione era disponibile.
Operazioni e dove si spostano i dati vecchi
GET /markets/trades elenca le operazioni eseguite con paginazione cursore. Kalshi divide i dati in livelli live e storici: una volta che un mercato si risolve prima del cutoff pubblicato in GET /historical/cutoff, esso e i suoi candlestick sono serviti da GET /historical/markets e /historical/markets/{ticker}/candlesticks, e le operazioni più vecchie da GET /historical/trades. Leggi il cutoff per ogni tipo di dato prima di assumere che un endpoint live abbia tutto.
Limiti di tariffa e polling
I limiti di Kalshi sono budget di token per livello, con bucket separati per lettura e scrittura, invece di un numero di richieste al secondo. Pollare l'endpoint orderbook per ogni mercato aperto consuma rapidamente il budget di lettura. Rispondi a un 429 con backoff esponenziale, pagina con il cursore finché non è vuoto, e usa il WebSocket autenticato quando ti servono tutti i cambiamenti del libro live.
Cosa l'API Kalshi non può darti
Nessun endpoint Kalshi restituisce le ladder yes e no come erano un'ora, una settimana o un mese fa. Un backtest che necessita spread e dimensione ferma a tempi decisionali passati necessita book registrati mentre erano live. DepthFeed ha interrogato book Kalshi full-depth da gennaio 2026: 1.5 miliardi di snapshot su 2,600,000+ mercati a giugno 21, 2026, serviti da REST o come 197 file Parquet giornalieri sigillati.
Aggiungi gli order book che l'API di Kalshi non conserva
L'API pubblica di Kalshi ti dà mercati, candele e operazioni gratuitamente. Quando un backtest necessita delle ladder yes e no a riposo in un momento passato, interroga i libri registrati di DepthFeed con una chiave gratuita o acquista giorni UTC interi come Parquet.
Ottieni una chiave API gratuita · Sfoglia i file giornalieri Kalshi
