---
title: "Kalshi events"
method: GET
path: "/kalshi/events"
tags: ["Kalshi"]
---

# Kalshi events

`GET /kalshi/events`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/kalshi/events`
- Auth: API key in header `x-api-key`

Lists Kalshi events, up to `limit` rows (default 25, max 200), continued with `cursor`. Filter by `series_ticker`, `category`, `status` (`open`, `closed` or `settled`), `min_close_ts` and `min_updated_ts`. `with_nested_markets` adds each event's markets. Each event has its ticker, title, category and strike period. A `cursor` is returned when more rows exist.

## Query parameters

- `limit` integer
- `cursor` string
- `series_ticker` string
- `category` string
- `status` 'open' | 'closed' | 'settled'
- `with_nested_markets` boolean
- `with_milestones` boolean
- `min_close_ts` integer
- `min_updated_ts` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- KalshiEventsResponseDoc
  - `code` integer
  - `data` KalshiEventsResponse
    - `cursor` string: Cursor to pass in the next request to get the following page. Omitted when Kalshi returns none.
    - `events` KalshiEventRow[]: Kalshi events on this page.
      - `available_on_brokers` boolean: Whether the event's markets can be traded through Kalshi's broker partners.
      - `category` string: Kalshi category of the event, such as `World`.
      - `collateral_return_type` string: Collateral return type Kalshi assigns to the event, such as `MECNET`.
      - `event_ticker` string: Kalshi ticker that identifies the event.
      - `last_updated` string: Time the event was last updated, in UTC (RFC 3339).
      - `markets` KalshiMarketRow[]: Markets that belong to the event. Omitted when the response does not include them.
        - `close_time` string: Time trading closes, in UTC (RFC 3339).
        - `event_ticker` string: Ticker of the event the market belongs to.
        - `expiration_time` string: Time the market expires, in UTC (RFC 3339).
        - `last_price` number: Price of the most recent trade, in US dollars per contract.
        - `liquidity` number: Market liquidity, in US dollars.
        - `market_type` string: Market type, such as `binary`.
        - `no_ask` number: Lowest price asked for a No contract, in US dollars.
        - `no_bid` number: Highest price offered for a No contract, in US dollars.
        - `open_interest` number: Number of contracts currently open in the market.
        - `open_time` string: Time trading opened, in UTC (RFC 3339).
        - `previous_price` number: Earlier reference price of the market, in US dollars per contract.
        - `response_price_unit` string: Price unit label Kalshi attaches to the market, such as `usd_cent`.
        - `result` string: Outcome the market settled on. Empty or omitted until it settles.
        - `rules_primary` string: Primary rules text that governs how the market settles.
        - `status` string: Market status as Kalshi reports it, such as `active`.
        - `sub_title` string: Short label of the outcome the market covers, shown under the title.
        - `ticker` string: Kalshi ticker that identifies the market.
        - `title` string: Market title as shown on Kalshi.
        - `volume` number: Total number of contracts traded in the market.
        - `volume_24h` number: Number of contracts traded in the last 24 hours.
        - `yes_ask` number: Lowest price asked for a Yes contract, in US dollars.
        - `yes_bid` number: Highest price offered for a Yes contract, in US dollars.
      - `mutually_exclusive` boolean: Whether at most one market in the event can resolve to Yes.
      - `series_ticker` string: Ticker of the series the event belongs to.
      - `strike_period` string: Strike period of the event, as Kalshi labels it.
      - `sub_title` string: Short qualifier shown under the event title, such as a date or deadline.
      - `title` string: Event title as shown on Kalshi.
    - `fetched_at` string: Time the data was fetched, in UTC (RFC 3339).
    - `limit` integer: Number of events requested per page.
    - `source_url` string: URL the data was read from.
  - `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/0497899e2016?raw)