exchange
orders
order-groups
portfolio
market
events
incentive-programs
structured-targets
milestone
communications
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",
"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": 123,
"yes_bid_dollars": "0.5600",
"yes_ask": 123,
"yes_ask_dollars": "0.5600",
"no_bid": 123,
"no_bid_dollars": "0.5600",
"no_ask": 123,
"no_ask_dollars": "0.5600",
"last_price": 123,
"last_price_dollars": "0.5600",
"volume": 123,
"volume_24h": 123,
"result": "yes",
"can_close_early": true,
"open_interest": 123,
"notional_value": 123,
"notional_value_dollars": "0.5600",
"previous_yes_bid": 123,
"previous_yes_bid_dollars": "0.5600",
"previous_yes_ask": 123,
"previous_yes_ask_dollars": "0.5600",
"previous_price": 123,
"previous_price_dollars": "0.5600",
"liquidity": 123,
"liquidity_dollars": "0.5600",
"expiration_value": "<string>",
"category": "<string>",
"risk_limit_cents": 123,
"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": 123,
"settlement_value_dollars": "0.5600",
"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>"
}
],
"primary_participant_key": "<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",
"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": 123,
"yes_bid_dollars": "0.5600",
"yes_ask": 123,
"yes_ask_dollars": "0.5600",
"no_bid": 123,
"no_bid_dollars": "0.5600",
"no_ask": 123,
"no_ask_dollars": "0.5600",
"last_price": 123,
"last_price_dollars": "0.5600",
"volume": 123,
"volume_24h": 123,
"result": "yes",
"can_close_early": true,
"open_interest": 123,
"notional_value": 123,
"notional_value_dollars": "0.5600",
"previous_yes_bid": 123,
"previous_yes_bid_dollars": "0.5600",
"previous_yes_ask": 123,
"previous_yes_ask_dollars": "0.5600",
"previous_price": 123,
"previous_price_dollars": "0.5600",
"liquidity": 123,
"liquidity_dollars": "0.5600",
"expiration_value": "<string>",
"category": "<string>",
"risk_limit_cents": 123,
"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": 123,
"settlement_value_dollars": "0.5600",
"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>"
}
],
"primary_participant_key": "<string>"
}
]
}Get Event
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>",
"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",
"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": 123,
"yes_bid_dollars": "0.5600",
"yes_ask": 123,
"yes_ask_dollars": "0.5600",
"no_bid": 123,
"no_bid_dollars": "0.5600",
"no_ask": 123,
"no_ask_dollars": "0.5600",
"last_price": 123,
"last_price_dollars": "0.5600",
"volume": 123,
"volume_24h": 123,
"result": "yes",
"can_close_early": true,
"open_interest": 123,
"notional_value": 123,
"notional_value_dollars": "0.5600",
"previous_yes_bid": 123,
"previous_yes_bid_dollars": "0.5600",
"previous_yes_ask": 123,
"previous_yes_ask_dollars": "0.5600",
"previous_price": 123,
"previous_price_dollars": "0.5600",
"liquidity": 123,
"liquidity_dollars": "0.5600",
"expiration_value": "<string>",
"category": "<string>",
"risk_limit_cents": 123,
"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": 123,
"settlement_value_dollars": "0.5600",
"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>"
}
],
"primary_participant_key": "<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",
"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": 123,
"yes_bid_dollars": "0.5600",
"yes_ask": 123,
"yes_ask_dollars": "0.5600",
"no_bid": 123,
"no_bid_dollars": "0.5600",
"no_ask": 123,
"no_ask_dollars": "0.5600",
"last_price": 123,
"last_price_dollars": "0.5600",
"volume": 123,
"volume_24h": 123,
"result": "yes",
"can_close_early": true,
"open_interest": 123,
"notional_value": 123,
"notional_value_dollars": "0.5600",
"previous_yes_bid": 123,
"previous_yes_bid_dollars": "0.5600",
"previous_yes_ask": 123,
"previous_yes_ask_dollars": "0.5600",
"previous_price": 123,
"previous_price_dollars": "0.5600",
"liquidity": 123,
"liquidity_dollars": "0.5600",
"expiration_value": "<string>",
"category": "<string>",
"risk_limit_cents": 123,
"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": 123,
"settlement_value_dollars": "0.5600",
"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>"
}
],
"primary_participant_key": "<string>"
}
]
}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
Data for the event.
Show child attributes
Show child attributes
Unique identifier for this event.
Unique identifier for the series this event belongs to.
Shortened descriptive title for the event.
Full title of the event.
Specifies how collateral is returned when markets settle (e.g., 'binary' for standard yes/no markets).
If true, only one market in this event can resolve to 'yes'. If false, multiple markets can resolve to 'yes'.
Event category (deprecated, use series-level category instead).
Whether this event is available to trade on brokers.
Additional metadata for the event.
The specific date this event is based on. Only filled when the event uses a date strike (mutually exclusive with strike_period).
The time period this event covers (e.g., 'week', 'month'). Only filled when the event uses a period strike (mutually exclusive with strike_date).
Array of markets associated with this event. Only populated when 'with_nested_markets=true' is specified in the request.
Show child attributes
Show child attributes
Identifies the type of market
binary, scalar Shortened title for the yes side of this market
Shortened title for the no side of this market
Latest possible time for this market to expire
The amount of time after determination that the market settles
initialized, active, closed, settled, determined The units used to express all price related fields
usd_cent Price for the highest YES buy offer on this market in dollars
"0.5600"
Price for the lowest YES sell offer on this market in dollars
"0.5600"
Price for the highest NO buy offer on this market in dollars
"0.5600"
Price for the lowest NO sell offer on this market in dollars
"0.5600"
Price for the last traded YES contract on this market in dollars
"0.5600"
yes, no, Number of contracts bought on this market disconsidering netting
The total value of a single contract at settlement in cents
The total value of a single contract at settlement in dollars
"0.5600"
Price for the highest YES buy offer on this market a day ago in cents
Price for the highest YES buy offer on this market a day ago in dollars
"0.5600"
Price for the lowest YES sell offer on this market a day ago in cents
Price for the lowest YES sell offer on this market a day ago in dollars
"0.5600"
Price for the last traded YES contract on this market a day ago in cents
Price for the last traded YES contract on this market a day ago in dollars
"0.5600"
Value for current offers in this market in cents
Value for current offers in this market in dollars
"0.5600"
The value that was considered for the settlement
The minimum price movement in the market
A plain language description of the most important market terms
A plain language description of secondary market terms
Price level structure for this market, defining price ranges and tick sizes
Valid price ranges for orders on this market
Time when this market is expected to expire
The settlement value of the YES/LONG side of the contract in cents. Only filled after determination
The settlement value of the YES/LONG side of the contract in dollars. Only filled after determination
"0.5600"
Time when this market's fee waiver expires
The condition under which the market can close early
Strike type defines how the market strike is defined and evaluated
greater, greater_or_equal, less, less_or_equal, between, functional, custom, structured Minimum expiration value that leads to a YES settlement
Maximum expiration value that leads to a YES settlement
Mapping from expiration values to settlement values
Expiration value for each target that leads to a YES settlement
The ticker of the multivariate event collection
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
Show child attributes
Identifies the type of market
binary, scalar Shortened title for the yes side of this market
Shortened title for the no side of this market
Latest possible time for this market to expire
The amount of time after determination that the market settles
initialized, active, closed, settled, determined The units used to express all price related fields
usd_cent Price for the highest YES buy offer on this market in dollars
"0.5600"
Price for the lowest YES sell offer on this market in dollars
"0.5600"
Price for the highest NO buy offer on this market in dollars
"0.5600"
Price for the lowest NO sell offer on this market in dollars
"0.5600"
Price for the last traded YES contract on this market in dollars
"0.5600"
yes, no, Number of contracts bought on this market disconsidering netting
The total value of a single contract at settlement in cents
The total value of a single contract at settlement in dollars
"0.5600"
Price for the highest YES buy offer on this market a day ago in cents
Price for the highest YES buy offer on this market a day ago in dollars
"0.5600"
Price for the lowest YES sell offer on this market a day ago in cents
Price for the lowest YES sell offer on this market a day ago in dollars
"0.5600"
Price for the last traded YES contract on this market a day ago in cents
Price for the last traded YES contract on this market a day ago in dollars
"0.5600"
Value for current offers in this market in cents
Value for current offers in this market in dollars
"0.5600"
The value that was considered for the settlement
The minimum price movement in the market
A plain language description of the most important market terms
A plain language description of secondary market terms
Price level structure for this market, defining price ranges and tick sizes
Valid price ranges for orders on this market
Time when this market is expected to expire
The settlement value of the YES/LONG side of the contract in cents. Only filled after determination
The settlement value of the YES/LONG side of the contract in dollars. Only filled after determination
"0.5600"
Time when this market's fee waiver expires
The condition under which the market can close early
Strike type defines how the market strike is defined and evaluated
greater, greater_or_equal, less, less_or_equal, between, functional, custom, structured Minimum expiration value that leads to a YES settlement
Maximum expiration value that leads to a YES settlement
Mapping from expiration values to settlement values
Expiration value for each target that leads to a YES settlement
The ticker of the multivariate event collection