---
title: "Kalshi event history"
method: GET
path: "/kalshi/event/{event_ticker}/history"
tags: ["Kalshi"]
---

# Kalshi event history

`GET /kalshi/event/{event_ticker}/history`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/kalshi/event/{event_ticker}/history`
- Auth: API key in header `x-api-key`

Returns candlesticks for the markets in a Kalshi event, grouped by market, for `event_ticker`. `start_ts` defaults to 7 days ago, `end_ts` to now, `period_interval` to 1440 minutes, and `series_ticker` to the ticker prefix before the last dash. Each candle has price, yes bid and ask, volume and open interest. Ranges are capped at 366 days.

## Path parameters

- `event_ticker` string, required

## Query parameters

- `series_ticker` string
- `start_ts` integer
- `end_ts` integer
- `period_interval` integer
- `include_latest_before_start` boolean

## Headers

- `x-api-key` string, required

## Response `200`

OK

- KalshiEventHistoryResponseDoc
  - `code` integer
  - `data` KalshiEventHistoryResponse
    - `adjusted_end_ts` integer: End of the range after Kalshi adjusted it, in Unix seconds.
    - `end_ts` integer: End of the requested range, in Unix seconds.
    - `event_ticker` string: Ticker of the Kalshi event the history is for.
    - `fetched_at` string: Time the data was fetched, in UTC (RFC 3339).
    - `include_latest_before_start` boolean: Whether the latest candle before `start_ts` was requested.
    - `market_tickers` string[]: Tickers of the markets in the event that have history.
    - `markets` KalshiMarketHistoryResponse[]: Candlestick history for each market in the event.
      - `candlesticks` KalshiMarketCandlestick[]: Price candlesticks for the market, one per period.
        - `end_period_at` string: End of the candlestick period, in UTC (RFC 3339).
        - `end_period_ts` integer: End of the candlestick period, in Unix seconds.
        - `open_interest` number: Number of contracts open at the end of the period.
        - `price` KalshiCandleOHLC
          - `close` number: Value at the end of the period, in US dollars per contract.
          - `high` number: Highest value during the period, in US dollars per contract.
          - `low` number: Lowest value during the period, in US dollars per contract.
          - `mean` number: Average value over the period, in US dollars per contract.
          - `open` number: Value at the start of the period, in US dollars per contract.
          - `previous` number: Last value from before the period, in US dollars per contract.
        - `volume` number: Number of contracts traded during the period.
        - `yes_ask` KalshiCandleOHLC
          - `close` number: Value at the end of the period, in US dollars per contract.
          - `high` number: Highest value during the period, in US dollars per contract.
          - `low` number: Lowest value during the period, in US dollars per contract.
          - `mean` number: Average value over the period, in US dollars per contract.
          - `open` number: Value at the start of the period, in US dollars per contract.
          - `previous` number: Last value from before the period, in US dollars per contract.
        - `yes_bid` KalshiCandleOHLC
          - `close` number: Value at the end of the period, in US dollars per contract.
          - `high` number: Highest value during the period, in US dollars per contract.
          - `low` number: Lowest value during the period, in US dollars per contract.
          - `mean` number: Average value over the period, in US dollars per contract.
          - `open` number: Value at the start of the period, in US dollars per contract.
          - `previous` number: Last value from before the period, in US dollars per contract.
      - `end_ts` integer: End of the requested range, in Unix seconds.
      - `fetched_at` string: Time the data was fetched, in UTC (RFC 3339).
      - `include_latest_before_start` boolean: Whether the latest candle before `start_ts` was requested.
      - `period_interval` integer: Length of each candlestick period, in minutes.
      - `series_ticker` string: Ticker of the series the market belongs to.
      - `source_url` string: URL the data was read from.
      - `start_ts` integer: Start of the requested range, in Unix seconds.
      - `ticker` string: Ticker of the Kalshi market the history is for.
    - `period_interval` integer: Length of each candlestick period, in minutes.
    - `series_ticker` string: Ticker of the series the event belongs to.
    - `source_url` string: URL the data was read from.
    - `start_ts` integer: Start of the requested range, in Unix seconds.
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)