Dados da API Kalshi
Dados da API Kalshi: Mercados, Livros de Ordens, Velas e Negociações
A API pública da Kalshi retorna séries, eventos, mercados, o livro de ordens atual, velas e negociações, e nenhuma dessas chamadas precisa de chave API. O que não retorna é o livro de ordens em um momento passado. Esta página mapeia cada tipo de dado Kalshi para seu endpoint, mostra as chamadas e cobre a lacuna com 1.5 bilhões de livros registrados.
Dados da API Kalshi são os dados da bolsa servidos pela Trade API da Kalshi em https://external-api.kalshi.com/trade-api/v2. Dados públicos de mercado cobrem séries, eventos, mercados, livro de ordens atual, velas e negociações; dados liquidados mais antigos que um corte publicado movem-se para endpoints /historical. Dados de conta (ordens, preenchimentos, posições) precisam de requisições com chave API assinada RSA.
Navegar arquivos diários Kalshi
Um livro de ordens Kalshi, conforme registrado
Copiado de uma observação BTC 15 minutos armazenada no arquivo do DepthFeed. A resposta do livro de ordens Kalshi carrega as mesmas duas escadas de compra para o momento atual.
Um lance sim a preço p é uma oferta não a 1 − p, então o ask sim implícito é 1 − o melhor lance não.: poll REST de profundidade total.
- yes_dollars / yes_prices
- Bids yes em espera como preço e contagem de contratos, melhor primeiro.
- sem_dólares / sem_precos
- Bids no em espera. Cada um é uma oferta yes a 1 − preço, que dá o ask yes implícito (0.33 aqui).
- ticker
- O ticker exato do mercado, incluindo o strike.
- recv_ts_ms
- Tempo de recebimento do DepthFeed em milissegundos epoch; a resposta do livro da Kalshi não tem timestamp da exchange.
Dados da API Kalshi em resumo
- URL base
- https://external-api.kalshi.com/trade-api/v2
- Autenticação de dados de mercado
- Nenhum para séries, eventos, mercados, livro de ordens, velas e negociações
- Autenticação de dados da conta
- Cabeçalhos de chave API assinados por RSA
- Livro de ordens
- Escadas atuais de compra e venda sim e não; venda = 1 − melhor compra oposta
- Períodos de candlestick
- 1 minuto · 1 hora · 1 dia
- Dados liquidados mais antigos
- Endpoints /historical após a data limite publicada
- Livros de ordens passados
- Não servido pela Kalshi; DepthFeed os registra desde 2026-01-08
Busque dados da API Kalshi com curl
Cada chamada abaixo é pública. Substitua os tickers pelos da primeira resposta; timestamps são segundos 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"- Siga o campo cursor até que ele volte vazio.
- Ler o ask yes como 1 − melhor bid no; o livro não tem array de ask.
- Mercados liquidados antes do corte estão apenas nos endpoints /historical.
Dados da API Kalshi
O que a API Kalshi retorna e de onde
Séries, eventos e mercados: a hierarquia
Uma série é uma pergunta recorrente (KXBTC15M é Bitcoin a cada 15 minutos), um evento é uma instância dela, e um mercado é um contrato negociável sim/não dentro do evento, com seu strike no ticker. GET /series/{series_ticker}, GET /events/{event_ticker} e GET /markets?series_ticker=… os retornam. Use o ticker de mercado completo como chave de junção: um ticker de evento nomeia vários mercados com preços muito diferentes.
Dados de mercado sem chave API
Kalshi documenta seus endpoints de dados de mercado como públicos: não são necessárias cabeçalhos de chave API para séries, eventos, mercados, livro de ordens, velas ou negociações. A URL base de produção é https://external-api.kalshi.com/trade-api/v2; o host mais antigo api.elections.kalshi.com serve os mesmos mercados, não apenas eleições. Chaves são necessárias para o lado da conta (ordens, preenchimentos, posições) e para o feed WebSocket.
O livro de ofertas: apenas ofertas de compra, e apenas atual
GET /markets/{ticker}/orderbook retorna duas escadas de bids, sim e não, como preços em dólar com contagem de contratos (orderbook_fp.yes_dollars e no_dollars). Não há array de ask: um bid não em p é uma oferta sim em 1 − p, então na amostra gravada nesta página o melhor bid sim é 0.32, o melhor bid não é 0.67 e o ask sim implícito é 0.33. A resposta é o livro agora; chamá-lo novamente depois não informa o que era.
Candlesticks: 1 minuto, horário ou diário
GET /series/{series_ticker}/markets/{ticker}/candlesticks aceita start_ts, end_ts e period_interval de 1, 60 ou 1440 minutos. Cada candle carrega open, high, low e close para o bid sim, o ask sim e o preço negociado, além de volume e open interest. É a forma mais barata de traçar um mercado, mas registra o que foi negociado e onde o topo do livro fechou, não quanto tamanho estava disponível.
Negociações, e para onde os dados antigos se movem
GET /markets/trades lista trades executados com paginação por cursor. Kalshi divide dados em níveis ao vivo e históricos: uma vez que um mercado liquida antes do cutoff publicado em GET /historical/cutoff, ele e seus candlesticks são servidos por GET /historical/markets e /historical/markets/{ticker}/candlesticks, e trades mais antigos por GET /historical/trades. Leia o cutoff para cada tipo de dado antes de assumir que um endpoint ao vivo tem tudo.
Limites de taxa e polling
Os limites da Kalshi são orçamentos de tokens por nível, com baldes separados para leitura e escrita, em vez de um número de requisições por segundo. Sondar o endpoint do livro de ordens para cada mercado aberto usa rapidamente o orçamento de leitura. Responda a um 429 com backoff exponencial, pagine com o cursor até esvaziar e use o WebSocket autenticado quando precisar de cada mudança do livro ao vivo.
O que a API Kalshi não pode oferecer
Nenhum endpoint Kalshi retorna as escadas sim e não como estavam uma hora, uma semana ou um mês atrás. Um backtest que precisa do spread e tamanho em repouso em tempos de decisão passados precisa de livros registrados enquanto estavam ao vivo. DepthFeed tem consultado livros Kalshi em profundidade total desde janeiro 2026: 1.5 bilhões de snapshots em 2,600,000+ mercados até junho 21, 2026, servidos via REST ou como 197 arquivos Parquet diários selados.
Adicione os livros de ordens que a API da Kalshi não mantém
A API pública da Kalshi oferece mercados, velas e negociações gratuitamente. Quando um backtest precisa das escadas yes e no em repouso em um momento passado, consulte os livros registrados do DepthFeed com uma chave gratuita ou compre dias UTC inteiros como Parquet.
Obtenha uma chave API gratuita · Navegar arquivos diários Kalshi
