Skip to main content
GET
/
events
/
{event_ticker}
Get Event
curl --request GET \
  --url https://api.elections.kalshi.com/trade-api/v2/events/{event_ticker}
{
  "event": {
    "event_ticker": "<string>",
    "series_ticker": "<string>",
    "sub_title": "<string>",
    "title": "<string>",
    "collateral_return_type": "<string>",
    "mutually_exclusive": true,
    "category": "<string>",
    "available_on_brokers": true,
    "product_metadata": {},
    "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>",
        "created_time": "2023-11-07T05:31:56Z",
        "updated_time": "2023-11-07T05:31:56Z",
        "open_time": "2023-11-07T05:31:56Z",
        "close_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": "usd_cent",
        "yes_bid_dollars": "0.5600",
        "yes_bid_size_fp": "10.00",
        "yes_ask_dollars": "0.5600",
        "yes_ask_size_fp": "10.00",
        "no_bid_dollars": "0.5600",
        "no_ask_dollars": "0.5600",
        "last_price_dollars": "0.5600",
        "volume_fp": "10.00",
        "volume_24h_fp": "10.00",
        "result": "yes",
        "can_close_early": true,
        "fractional_trading_enabled": true,
        "open_interest_fp": "10.00",
        "notional_value_dollars": "0.5600",
        "previous_yes_bid_dollars": "0.5600",
        "previous_yes_ask_dollars": "0.5600",
        "previous_price_dollars": "0.5600",
        "liquidity_dollars": "0.5600",
        "expiration_value": "<string>",
        "tick_size": 123,
        "rules_primary": "<string>",
        "rules_secondary": "<string>",
        "price_level_structure": "<string>",
        "price_ranges": [
          {
            "start": "<string>",
            "end": "<string>",
            "step": "<string>"
          }
        ],
        "expected_expiration_time": "2023-11-07T05:31:56Z",
        "settlement_value_dollars": "0.5600",
        "settlement_ts": "2023-11-07T05:31:56Z",
        "fee_waiver_expiration_time": "2023-11-07T05:31:56Z",
        "early_close_condition": "<string>",
        "strike_type": "greater",
        "floor_strike": 123,
        "cap_strike": 123,
        "functional_strike": "<string>",
        "custom_strike": {},
        "mve_collection_ticker": "<string>",
        "mve_selected_legs": [
          {
            "event_ticker": "<string>",
            "market_ticker": "<string>",
            "side": "<string>",
            "yes_settlement_value_dollars": "0.5600"
          }
        ],
        "primary_participant_key": "<string>",
        "is_provisional": true
      }
    ],
    "last_updated_ts": "2023-11-07T05:31:56Z"
  },
  "markets": [
    {
      "ticker": "<string>",
      "event_ticker": "<string>",
      "market_type": "binary",
      "title": "<string>",
      "subtitle": "<string>",
      "yes_sub_title": "<string>",
      "no_sub_title": "<string>",
      "created_time": "2023-11-07T05:31:56Z",
      "updated_time": "2023-11-07T05:31:56Z",
      "open_time": "2023-11-07T05:31:56Z",
      "close_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": "usd_cent",
      "yes_bid_dollars": "0.5600",
      "yes_bid_size_fp": "10.00",
      "yes_ask_dollars": "0.5600",
      "yes_ask_size_fp": "10.00",
      "no_bid_dollars": "0.5600",
      "no_ask_dollars": "0.5600",
      "last_price_dollars": "0.5600",
      "volume_fp": "10.00",
      "volume_24h_fp": "10.00",
      "result": "yes",
      "can_close_early": true,
      "fractional_trading_enabled": true,
      "open_interest_fp": "10.00",
      "notional_value_dollars": "0.5600",
      "previous_yes_bid_dollars": "0.5600",
      "previous_yes_ask_dollars": "0.5600",
      "previous_price_dollars": "0.5600",
      "liquidity_dollars": "0.5600",
      "expiration_value": "<string>",
      "tick_size": 123,
      "rules_primary": "<string>",
      "rules_secondary": "<string>",
      "price_level_structure": "<string>",
      "price_ranges": [
        {
          "start": "<string>",
          "end": "<string>",
          "step": "<string>"
        }
      ],
      "expected_expiration_time": "2023-11-07T05:31:56Z",
      "settlement_value_dollars": "0.5600",
      "settlement_ts": "2023-11-07T05:31:56Z",
      "fee_waiver_expiration_time": "2023-11-07T05:31:56Z",
      "early_close_condition": "<string>",
      "strike_type": "greater",
      "floor_strike": 123,
      "cap_strike": 123,
      "functional_strike": "<string>",
      "custom_strike": {},
      "mve_collection_ticker": "<string>",
      "mve_selected_legs": [
        {
          "event_ticker": "<string>",
          "market_ticker": "<string>",
          "side": "<string>",
          "yes_settlement_value_dollars": "0.5600"
        }
      ],
      "primary_participant_key": "<string>",
      "is_provisional": true
    }
  ]
}

Path Parameters

​
event_ticker
string
required

Event ticker

Query Parameters

​
with_nested_markets
boolean
default:false

If true, markets are included within the event object. If false (default), markets are returned as a separate top-level field in the response. Historical markets settled before the historical cutoff will not be included.

Response

Event retrieved successfully

​
event
object
required

Data for the event.

​
markets
object[]
required

Data for the markets in this event. This field is deprecated in favour of the "markets" field inside the event. Which will be filled with the same value if you use the query parameter "with_nested_markets=true".