KAkalshi
events

Get Event

Changed on

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. All events are accessible through this endpoint, even if their associated markets are older than the historical cutoff.

get/events/{event_ticker}

Request

  • Base URL
    https://external-api.kalshi.com/trade-api/v2
  • URL
    https://external-api.kalshi.com/trade-api/v2/events/{event_ticker}
  • Auth
    none declared

Path parameters

event_tickerstring required

Event ticker

Query parameters

exclude_marketsboolean

Return event metadata without loading child markets. Use GET /markets with event_ticker, limit and cursor for bounded market pages. Cannot be combined with with_nested_markets=true.

with_nested_marketsboolean

If true, markets are included within the event object. If false (default), markets are returned as a separate top-level field in the response. Historical markets settled before the historical cutoff will not be included.

Response

Event retrieved successfully

Example response

{
  "event": {
    "markets": [
      {
        "yes_bid_dollars": "0.5600",
        "yes_bid_size_fp": "10.00",
        "yes_ask_dollars": "0.5600",
        "yes_ask_size_fp": "10.00",
        "no_bid_dollars": "0.5600",
        "no_ask_dollars": "0.5600",
        "last_price_dollars": "0.5600",
        "volume_fp": "10.00",
        "volume_24h_fp": "10.00",
        "open_interest_fp": "10.00",
        "notional_value_dollars": "0.5600",
        "previous_yes_bid_dollars": "0.5600",
        "previous_yes_ask_dollars": "0.5600",
        "previous_price_dollars": "0.5600",
        "settlement_value_dollars": "0.5600",
        "settlement_floor_dollars": "0.5600",
        "mve_selected_legs": [
          {
            "yes_settlement_value_dollars": "0.5600"
          }
        ]
      }
    ]
  },
  "markets": [
    {
      "yes_bid_dollars": "0.5600",
      "yes_bid_size_fp": "10.00",
      "yes_ask_dollars": "0.5600",
      "yes_ask_size_fp": "10.00",
      "no_bid_dollars": "0.5600",
      "no_ask_dollars": "0.5600",
      "last_price_dollars": "0.5600",
      "volume_fp": "10.00",
      "volume_24h_fp": "10.00",
      "open_interest_fp": "10.00",
      "notional_value_dollars": "0.5600",
      "previous_yes_bid_dollars": "0.5600",
      "previous_yes_ask_dollars": "0.5600",
      "previous_price_dollars": "0.5600",
      "settlement_value_dollars": "0.5600",
      "settlement_floor_dollars": "0.5600",
      "mve_selected_legs": [
        {
          "yes_settlement_value_dollars": "0.5600"
        }
      ]
    }
  ]
}

Changes