# List Event Market Snapshots

Retrieves the latest market snapshot for a single event contract market, including yes/no bid-ask prices, last trade price, volume, open interest, and market status.

# OpenAPI definition

```json
{
  "info": {
    "title": "Webull Open API Reference",
    "description": "application.yml\\ncom\\ni18n\\nMETA-INF\\nstatic\\n\\r\\n",
    "contact": {
      "name": "",
      "url": "",
      "email": ""
    },
    "version": "2.0",
    "x-logo": {
      "url": "static/png/logo.png"
    }
  },
  "servers": [
    {
      "url": "https://us-global-openapi.uat.webullbroker.com"
    }
  ],
  "path": "/market-data/event-contracts/markets/snapshots/list",
  "method": "get",
  "tags": [
    "Event Contract Market Data"
  ],
  "description": "Retrieves the latest market snapshot for a single event contract market, including yes/no bid-ask prices, last trade price, volume, open interest, and market status.",
  "operationId": "eventMarketSnapshotUsingGET",
  "parameters": [
    {
      "name": "symbol",
      "in": "query",
      "description": "Market symbol. A market is a single binary contract within an event.",
      "required": true,
      "schema": {
        "type": "string"
      },
      "example": "KXNBA-LAL-BOS-0415-ML"
    },
    {
      "name": "category",
      "in": "query",
      "description": "Category, default is US_EVENT, currently only US_EVENT is supported.",
      "required": false,
      "schema": {
        "type": "string",
        "enum": [
          "US_EVENT"
        ],
        "default": "US_EVENT"
      },
      "example": "US_EVENT"
    },
    {
      "name": "access_token",
      "in": "header",
      "description": "User's authenticated token.",
      "required": true,
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "reqid",
      "in": "header",
      "description": "The unique ID for this request. Suggest using UUID.",
      "schema": {
        "type": "string"
      },
      "example": "2e46d5a4-bef9-4507-8cda-98f85d2f770c"
    }
  ],
  "responses": {
    "200": {
      "description": "OK",
      "content": {
        "application/json": {
          "schema": {
            "required": [
              "instrument_id",
              "symbol"
            ],
            "type": "object",
            "properties": {
              "symbol": {
                "type": "string",
                "description": "Contract symbol",
                "example": "KXNBA-LAL-BOS-0415-ML"
              },
              "instrument_id": {
                "type": "string",
                "description": "Contract instrument ID",
                "example": "9878278271"
              },
              "event_symbol": {
                "type": "string",
                "description": "Parent event symbol",
                "example": "KXNBA-LAL-BOS-0415"
              },
              "yes_sub_title": {
                "type": "string",
                "description": "Yes side subtitle (e.g. 'Lakers Win')",
                "example": "Lakers Win"
              },
              "no_sub_title": {
                "type": "string",
                "description": "No side subtitle (e.g. 'Celtics Win')",
                "example": "Celtics Win"
              },
              "status": {
                "type": "string",
                "description": "Market status. ACTIVE=Market is open for trading; INACTIVE=Market is closed, no new orders accepted.",
                "example": "ACTIVE"
              },
              "yes_bid": {
                "type": "string",
                "description": "Yes side best bid price",
                "example": "0.56"
              },
              "yes_ask": {
                "type": "string",
                "description": "Yes side best ask price",
                "example": "0.58"
              },
              "no_bid": {
                "type": "string",
                "description": "No side best bid price",
                "example": "0.42"
              },
              "no_ask": {
                "type": "string",
                "description": "No side best ask price",
                "example": "0.44"
              },
              "price": {
                "type": "string",
                "description": "Price for the last traded YES contract on this market in dollars.",
                "example": "0.57"
              },
              "volume": {
                "type": "string",
                "description": "String representation of the market volume in contracts.",
                "example": "12500.0"
              },
              "open_interest": {
                "type": "string",
                "description": "String representation of the number of contracts bought on this market disregarding netting.",
                "example": "8500.0"
              },
              "last_trade_time": {
                "type": "string",
                "description": "Timestamp of the most recent trade. Format: ISO 8601 with timezone offset.",
                "example": "2026-05-27T09:03:50.000+0000"
              }
            },
            "description": "EventContractSnapshotVo",
            "title": "EventContractSnapshotVo"
          }
        }
      }
    },
    "401": {
      "description": "Unauthorized: Authentication required",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error_code": {
                "type": "string",
                "description": "Internal logic error code"
              },
              "message": {
                "type": "string",
                "description": "Error message"
              }
            },
            "description": "ErrorResponseVo",
            "title": "ErrorResponseVo"
          },
          "example": {
            "error_code": "UNAUTHORIZED",
            "message": "Insufficient permission"
          }
        }
      }
    },
    "417": {
      "description": "A business logic error triggered when the request cannot be processed due to domain-specific constraints.",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error_code": {
                "type": "string",
                "description": "Internal logic error code"
              },
              "message": {
                "type": "string",
                "description": "Error message"
              }
            },
            "description": "ErrorResponseVo",
            "title": "ErrorResponseVo"
          },
          "example": {
            "error_code": "UNSUPPORTED_CATEGORY",
            "message": "Unsupported category:US_EVENTS"
          }
        }
      }
    }
  },
  "postman": {
    "name": "List Event Market Snapshots",
    "description": {
      "content": "Retrieves the latest market snapshot for a single event contract market, including yes/no bid-ask prices, last trade price, volume, open interest, and market status.",
      "type": "text/plain"
    },
    "url": {
      "path": [
        "market-data",
        "event-contracts",
        "markets",
        "snapshots",
        "list"
      ],
      "host": [
        "{{baseUrl}}"
      ],
      "query": [
        {
          "disabled": false,
          "description": {
            "content": "(Required) Market symbol. A market is a single binary contract within an event.",
            "type": "text/plain"
          },
          "key": "symbol",
          "value": ""
        },
        {
          "disabled": false,
          "description": {
            "content": "Category, default is US_EVENT, currently only US_EVENT is supported.",
            "type": "text/plain"
          },
          "key": "category",
          "value": ""
        }
      ],
      "variable": []
    },
    "header": [
      {
        "disabled": false,
        "description": {
          "content": "(Required) User's authenticated token.",
          "type": "text/plain"
        },
        "key": "access_token",
        "value": ""
      },
      {
        "disabled": false,
        "description": {
          "content": "The unique ID for this request. Suggest using UUID.",
          "type": "text/plain"
        },
        "key": "reqid",
        "value": ""
      },
      {
        "key": "Accept",
        "value": "application/json"
      }
    ],
    "method": "GET"
  }
}
```