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

# Kalshi market history

`GET /kalshi/market/{ticker}/history`

## Request

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

Returns candlesticks for one Kalshi market by `ticker`. `series_ticker` defaults to the ticker prefix before the last dash, `start_ts` to 7 days ago, `end_ts` to now and `period_interval` to 1440 minutes. `include_latest_before_start` adds the last candle before the start. Ranges are capped at 366 days.

## Path parameters

- `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

- KalshiMarketHistoryResponseDoc
  - `code` integer
  - `data` KalshiMarketHistoryResponse
    - `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.
  - `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/028417aa35bb?raw)