# List Event Market Bars

Retrieves historical OHLCV bar data for one or more event contract markets, keyed by market symbol. Use this endpoint to build price charts for individual contract markets. Maximum 100 symbols per request.

# 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",
  "method": "get",
  "tags": [
    "Event Contract Market Data"
  ],
  "description": "Retrieves historical OHLCV bar data for one or more event contract markets, keyed by market symbol. Use this endpoint to build price charts for individual contract markets. Maximum 100 symbols per request.",
  "operationId": "eventMarketBarsUsingGET",
  "parameters": [
    {
      "name": "symbols",
      "in": "query",
      "description": "Comma-separated market symbols. A market is a single binary contract within an event. Maximum 100 symbols.",
      "required": true,
      "schema": {
        "type": "string"
      },
      "example": "KXNBA-LAL-BOS-0415-ML,KXNBA-LAL-BOS-0415-SPREAD"
    },
    {
      "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 Market Bars",
    "description": {
      "content": "Retrieves historical OHLCV bar data for one or more event contract markets, keyed by market symbol. Use this endpoint to build price charts for individual contract markets. Maximum 100 symbols per request.",
      "type": "text/plain"
    },
    "url": {
      "path": [
        "market-data",
        "event-contracts",
        "markets",
        "bars",
        "list"
      ],
      "host": [
        "{{baseUrl}}"
      ],
      "query": [
        {
          "disabled": false,
          "description": {
            "content": "(Required) Comma-separated market symbols. A market is a single binary contract within an event. Maximum 100 symbols.",
            "type": "text/plain"
          },
          "key": "symbols",
          "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"
  }
}
```