# List Event Bars by Event

Retrieves historical OHLCV bar data for all markets under a given event, keyed by market symbol. Use this endpoint to compare price movements across all contract outcomes within a single event.

# 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/bars/list-by-event",
  "method": "get",
  "tags": [
    "Event Contract Market Data"
  ],
  "description": "Retrieves historical OHLCV bar data for all markets under a given event, keyed by market symbol. Use this endpoint to compare price movements across all contract outcomes within a single event.",
  "operationId": "eventMarketBarsByEventUsingGET",
  "parameters": [
    {
      "name": "event_symbol",
      "in": "query",
      "description": "Event unique identifier. An event contains multiple markets (binary contracts).",
      "required": true,
      "schema": {
        "type": "string"
      },
      "example": "KXNBA-LAL-BOS-0415"
    },
    {
      "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": "start_time",
      "in": "query",
      "description": "Start time (unix timestamp in milliseconds). Empty means no lower bound.",
      "required": false,
      "schema": {
        "type": "integer",
        "format": "int64"
      },
      "example": 1700000000000
    },
    {
      "name": "end_time",
      "in": "query",
      "description": "End time (unix timestamp in milliseconds). Empty means no upper bound.",
      "required": false,
      "schema": {
        "type": "integer",
        "format": "int64"
      },
      "example": 1700100000000
    },
    {
      "name": "count",
      "in": "query",
      "description": "Number of bars. Range: 1-1200, default 200.",
      "required": false,
      "schema": {
        "type": "integer",
        "default": 200
      },
      "example": 200
    },
    {
      "name": "timespan",
      "in": "query",
      "description": "Bar time granularity. M1=1min, M5=5min, M15=15min, M30=30min, M60=1hour, M120=2hour, M240=4hour, D=Daily, W=Weekly, M=Monthly, Y=Yearly.",
      "required": true,
      "schema": {
        "type": "string"
      },
      "example": "M5"
    },
    {
      "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": "JSON object where key is market_symbol (string) and value is array of candlestick bar objects. See schema below for bar object fields.",
      "content": {
        "application/json": {
          "schema": {
            "type": "array",
            "items": {
              "required": [
                "end_period_time",
                "volume"
              ],
              "type": "object",
              "properties": {
                "end_period_time": {
                  "type": "string",
                  "description": "Bar end period time (UTC datetime)",
                  "example": "2021-12-28T09:00:09.945+0000"
                },
                "volume": {
                  "type": "string",
                  "description": "Volume during period",
                  "example": "450.0"
                },
                "open": {
                  "type": "string",
                  "description": "Open price (nullable)",
                  "example": "0.53"
                },
                "high": {
                  "type": "string",
                  "description": "High price (nullable)",
                  "example": "0.57"
                },
                "low": {
                  "type": "string",
                  "description": "Low price (nullable)",
                  "example": "0.51"
                },
                "close": {
                  "type": "string",
                  "description": "Close price (nullable)",
                  "example": "0.56"
                }
              },
              "description": "EventContractCandlestickVo",
              "title": "EventContractCandlestickVo"
            }
          },
          "example": {
            "KXNBAGAME-26MAY12MINSAS-MIN": [
              {
                "open": "0.23",
                "high": "0.24",
                "low": "0.18",
                "close": "0.19",
                "end_period_time": "2026-05-12T04:00:00.000+0000",
                "volume": "286472.18"
              }
            ],
            "KXNBAGAME-26MAY12MINSAS-SAS": [
              {
                "open": "0.78",
                "high": "0.95",
                "low": "0.71",
                "close": "0.94",
                "end_period_time": "2026-05-12T04:00:00.000+0000",
                "volume": "149897.77"
              }
            ]
          }
        }
      }
    },
    "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 Bars by Event",
    "description": {
      "content": "Retrieves historical OHLCV bar data for all markets under a given event, keyed by market symbol. Use this endpoint to compare price movements across all contract outcomes within a single event.",
      "type": "text/plain"
    },
    "url": {
      "path": [
        "market-data",
        "event-contracts",
        "markets",
        "bars",
        "list-by-event"
      ],
      "host": [
        "{{baseUrl}}"
      ],
      "query": [
        {
          "disabled": false,
          "description": {
            "content": "(Required) Event unique identifier. An event contains multiple markets (binary contracts).",
            "type": "text/plain"
          },
          "key": "event_symbol",
          "value": ""
        },
        {
          "disabled": false,
          "description": {
            "content": "Category, default is US_EVENT, currently only US_EVENT is supported.",
            "type": "text/plain"
          },
          "key": "category",
          "value": ""
        },
        {
          "disabled": false,
          "description": {
            "content": "Start time (unix timestamp in milliseconds). Empty means no lower bound.",
            "type": "text/plain"
          },
          "key": "start_time",
          "value": ""
        },
        {
          "disabled": false,
          "description": {
            "content": "End time (unix timestamp in milliseconds). Empty means no upper bound.",
            "type": "text/plain"
          },
          "key": "end_time",
          "value": ""
        },
        {
          "disabled": false,
          "description": {
            "content": "Number of bars. Range: 1-1200, default 200.",
            "type": "text/plain"
          },
          "key": "count",
          "value": ""
        },
        {
          "disabled": false,
          "description": {
            "content": "(Required) Bar time granularity. M1=1min, M5=5min, M15=15min, M30=30min, M60=1hour, M120=2hour, M240=4hour, D=Daily, W=Weekly, M=Monthly, Y=Yearly.",
            "type": "text/plain"
          },
          "key": "timespan",
          "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"
  }
}
```