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{
"events": [
{
"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>"
}
]
}
],
"cursor": "<string>",
"milestones": [
{
"id": "<string>",
"category": "<string>",
"type": "<string>",
"start_date": "2023-11-07T05:31:56Z",
"related_event_tickers": [
"<string>"
],
"title": "<string>",
"notification_message": "<string>",
"details": {},
"primary_event_tickers": [
"<string>"
],
"last_updated_ts": "2023-11-07T05:31:56Z",
"end_date": "2023-11-07T05:31:56Z",
"source_id": "<string>"
}
]
}Get Events
Get all events. This endpoint excludes multivariate events. To retrieve multivariate events, use the GET /events/multivariate endpoint.
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>",
"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>"
}
]
}
],
"cursor": "<string>",
"milestones": [
{
"id": "<string>",
"category": "<string>",
"type": "<string>",
"start_date": "2023-11-07T05:31:56Z",
"related_event_tickers": [
"<string>"
],
"title": "<string>",
"notification_message": "<string>",
"details": {},
"primary_event_tickers": [
"<string>"
],
"last_updated_ts": "2023-11-07T05:31:56Z",
"end_date": "2023-11-07T05:31:56Z",
"source_id": "<string>"
}
]
}Query Parameters
Parameter to specify the number of results per page. Defaults to 200. Maximum value is 200.
1 <= x <= 200Parameter 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.
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.
If true, includes related milestones as a field alongside events.
Filter by event status. Possible values are 'open', 'closed', 'settled'. Leave empty to return events with any status.
open, closed, settled Filter by series ticker
Filter events with at least one market with close timestamp greater than this Unix timestamp (in seconds).
Response
Events retrieved successfully
Array of events matching the query criteria.
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
Pagination cursor for the next page. Empty if there are no more results.
Array of milestones related to the events.
Show child attributes
Show child attributes
Unique identifier for the milestone.
Category of the milestone.
Type of the milestone.
Start date of the milestone.
List of event tickers related to this milestone.
Title of the milestone.
Notification message for the milestone.
Additional details about the milestone.
List of event tickers directly related to the outcome of this milestone.
Last time this structured target was updated.
End date of the milestone, if any.
Source id of milestone if available.