Path Parameters
Event ticker
Query Parameters
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
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>"
}
]
}
]
}Endpoint for getting data about an event by its ticker. An event represents a real-world occurrence that can be traded on, such as an election, sports game, or economic indicator release. Events contain one or more markets where users can place trades on different outcomes.
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>"
}
]
}
]
}Event ticker
If true, markets are included within the event object. If false (default), markets are returned as a separate top-level field in the response.
Event retrieved successfully
Data for the event.
Show child attributes
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".
Show child attributes