Skip to main content
GET
/
events
Get Events
curl --request GET \
  --url https://api.elections.kalshi.com/trade-api/v2/events
{
  "events": [
    {
      "event_ticker": "<string>",
      "series_ticker": "<string>",
      "sub_title": "<string>",
      "title": "<string>",
      "collateral_return_type": "<string>",
      "mutually_exclusive": true,
      "category": "<string>",
      "strike_date": "2023-11-07T05:31:56Z",
      "strike_period": "<string>",
      "markets": [
        {
          "ticker": "<string>",
          "event_ticker": "<string>",
          "market_type": "binary",
          "title": "<string>",
          "subtitle": "<string>",
          "yes_sub_title": "<string>",
          "no_sub_title": "<string>",
          "open_time": "2023-11-07T05:31:56Z",
          "close_time": "2023-11-07T05:31:56Z",
          "expected_expiration_time": "2023-11-07T05:31:56Z",
          "expiration_time": "2023-11-07T05:31:56Z",
          "latest_expiration_time": "2023-11-07T05:31:56Z",
          "settlement_timer_seconds": 123,
          "status": "initialized",
          "response_price_units": "cents",
          "yes_bid": 123,
          "yes_bid_dollars": "<string>",
          "yes_ask": 123,
          "yes_ask_dollars": "<string>",
          "no_bid": 123,
          "no_bid_dollars": "<string>",
          "no_ask": 123,
          "no_ask_dollars": "<string>",
          "last_price": 123,
          "last_price_dollars": "<string>",
          "volume": 123,
          "volume_24h": 123,
          "result": "yes",
          "can_close_early": true,
          "open_interest": 123,
          "notional_value": 123,
          "notional_value_dollars": "<string>",
          "previous_yes_bid": 123,
          "previous_yes_bid_dollars": "<string>",
          "previous_yes_ask": 123,
          "previous_yes_ask_dollars": "<string>",
          "previous_price": 123,
          "previous_price_dollars": "<string>",
          "liquidity": 123,
          "liquidity_dollars": "<string>",
          "settlement_value": 123,
          "settlement_value_dollars": "<string>",
          "expiration_value": "<string>",
          "category": "<string>",
          "risk_limit_cents": 123,
          "fee_waiver_expiration_time": "2023-11-07T05:31:56Z",
          "early_close_condition": "<string>",
          "tick_size": 123,
          "strike_type": "greater",
          "floor_strike": 123,
          "cap_strike": 123,
          "functional_strike": "<string>",
          "custom_strike": {},
          "rules_primary": "<string>",
          "rules_secondary": "<string>",
          "mve_collection_ticker": "<string>",
          "mve_selected_legs": [
            {
              "event_ticker": "<string>",
              "market_ticker": "<string>",
              "side": "<string>"
            }
          ],
          "primary_participant_key": "<string>",
          "price_level_structure": "<string>",
          "price_ranges": [
            {
              "start": "<string>",
              "end": "<string>",
              "step": "<string>"
            }
          ]
        }
      ],
      "available_on_brokers": true
    }
  ],
  "milestones": [
    {
      "id": "<string>",
      "category": "<string>",
      "type": "<string>",
      "start_date": "2023-11-07T05:31:56Z",
      "end_date": "2023-11-07T05:31:56Z",
      "related_event_tickers": [
        "<string>"
      ],
      "title": "<string>",
      "notification_message": "<string>",
      "source_id": "<string>",
      "details": {},
      "primary_event_tickers": [
        "<string>"
      ],
      "last_updated_ts": "2023-11-07T05:31:56Z"
    }
  ],
  "cursor": "<string>"
}

Query Parameters

​
limit
integer
default:100

Parameter to specify the number of results per page. Defaults to 100. Maximum value is 200.

Required range: 1 <= x <= 200
​
cursor
string

Parameter to specify the pagination cursor. Use the cursor value returned from the previous response to get the next page of results. Leave empty for the first page.

​
with_nested_markets
boolean
default:false

Parameter to specify if nested markets should be included in the response. When true, each event will include a 'markets' field containing a list of Market objects associated with that event.

​
with_milestones
boolean
default:false

If true, includes related milestones as a field alongside events.

​
status
enum<string>

Filter by event status. Possible values are 'open', 'closed', 'settled'. Leave empty to return events with any status.

Available options:
open,
closed,
settled
​
series_ticker
string

Filter events by series ticker. Returns only events belonging to the specified series.

​
min_close_ts
integer

Filter events with at least one market with close timestamp greater than this Unix timestamp (in seconds).

Response

Events retrieved successfully

​
events
object[]
required

Array of events matching the query criteria.

​
cursor
string
required

Pagination cursor for the next page. Empty if there are no more results.

​
milestones
object[]

Array of milestones related to the events.

⌘I