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/markets/{ticker}{
"market": {
"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 Market
Endpoint for getting data about a specific market by its ticker. A market represents a specific binary outcome within an event that users can trade on (e.g., “Will candidate X win?”). Markets have yes/no positions, current prices, volume, and settlement rules.
curl --request GET \
--url https://api.elections.kalshi.com/trade-api/v2/markets/{ticker}{
"market": {
"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
Market ticker
Response
Market retrieved successfully
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