v3

OpenAPI 3.0.02026-07-31103181312.8 KB

events

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

get/events/{event_ticker}

Path parameters

event_tickerstring required

Event ticker

Query parameters

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",
        "liquidity_dollars": "0.5600",
        "settlement_value_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",
      "liquidity_dollars": "0.5600",
      "settlement_value_dollars": "0.5600",
      "mve_selected_legs": [
        {
          "yes_settlement_value_dollars": "0.5600"
        }
      ]
    }
  ]
}