Skip to main content
The common.predictions.kalshi_markets table provides comprehensive metadata for Kalshi prediction markets including market details, pricing, settlement rules, and resolution outcomes. This table combines both settled and non-settled markets. Use this table to discover markets, analyze settlement patterns, understand market structure, and track outcomes across different categories.

Table Columns

Unique Key: market_unique_id
Column NameData TypeDescription
projectVARCHARProject identifier, always ‘kalshi’.
protocolVARCHARProtocol identifier, always ‘kalshi’.
market_unique_idVARCHARUnique identifier for the Kalshi market ticker.
market_event_idVARCHAREvent identifier that groups related markets together.
market_series_idVARCHARSeries ticker identifier for the event.
market_mve_idVARCHARMulti-variable event (MVE) collection ticker.
market_nameVARCHARMarket title describing the prediction question.
question_idVARCHARQuestion identifier (same as event_ticker).
questionVARCHARQuestion text from the event.
descriptionVARCHARMarket description.
last_token_priceFLOATLast traded price as a float (0-1 scale).
market_statusVARCHARCurrent status (active, open, closed, finalized, settled).
activeBOOLEANBoolean flag indicating if the market is active or open.
closedBOOLEANBoolean flag indicating if closed, finalized, or settled.
accepting_ordersBOOLEANBoolean flag indicating if currently accepting orders.
categoryVARCHARCategory classification of the market.
start_dateTIMESTAMP_NTZ(9)Timestamp when the market opened for trading.
end_dateTIMESTAMP_NTZ(9)Timestamp when the market closes for trading.
expected_expiration_timeTIMESTAMP_NTZ(9)Expected timestamp for market expiration.
expiration_timeTIMESTAMP_NTZ(9)Actual expiration timestamp of the market.
latest_expiration_timeTIMESTAMP_NTZ(9)Latest possible expiration timestamp.
seconds_delayNUMBERSettlement timer in seconds.
can_close_earlyBOOLEANBoolean flag indicating if the market can close before expiration.
expiration_valueVARCHARValue used to determine market settlement.
strike_typeVARCHARType of strike price (if applicable).
floor_strikeFLOATFloor strike price for ranged markets.
cap_strikeFLOATCap strike price for ranged markets.
rules_primaryVARCHARPrimary rules governing the market settlement.
rules_secondaryVARCHARSecondary rules for market settlement.
early_close_conditionVARCHARConditions under which the market can close early.
mve_collection_tickerVARCHARMulti-variable event collection ticker.
mve_selected_legsVARCHARSelected legs for multi-variable events.
market_outcome_resolutionVARCHARMarket outcome resolution (or ‘unresolved’ if still open).
resolved_atTIMESTAMP_NTZ(9)Timestamp when the market was resolved (expiration_time).

Understanding Market Structure

Market Status Flow

Markets progress through different statuses:
  1. active/open: Market is accepting trades
  2. closed: Market has stopped accepting new orders
  3. finalized: Market is awaiting settlement
  4. settled: Market outcome has been determined and market is settled

Multi-Variable Events (MVE)

MVE markets group multiple related prediction markets and conditions together into one. For example:
  • “Which NBA Player will score 20+ pts today?” might have markets for:
    • Yes. Stephen Curry
    • Yes. Lebron James
    • Yes. Kevin Durant
All these related markets share the same market_mve_id.