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>",
    "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
  },
  "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>"
        }
      ]
    }
  ]
}

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.

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".

I