Market Data API Overview
The Market Data API provides access to real-time and historical market data for Hong Kong stocks, US stocks, and China A-shares. It supports two access patterns:
- Data API — HTTP-based requests for historical and snapshot data. Ideal for backtesting, analysis, and on-demand queries. See Data API.
- Data Streaming API — Real-time data push via MQTT protocol over WebSocket/TCP. Ideal for live trading strategies and real-time monitoring. See Data Streaming API.
tip
The Webull SDK simplifies integration by handling authentication and protocol details. See SDKs and Tools for installation.
Supported Markets and Products
| Market | Product |
|---|---|
| Hong Kong | Stocks, ETFs |
| US | Stocks, ETFs |
| US | Options |
| US | Futures (CBOT, CME, COMEX, NYMEX) |
| US | Overnight Session |
| US | Order Flow (Footprint, TPO) |
| China Mainland | A-Shares (Stock Connect) |
Available Endpoints
Market Data
| Endpoint | Protocol | Description |
|---|---|---|
| Snapshot | HTTP | Real-time market snapshot with latest price, price change, volume, turnover rate, etc. Supports pre-market, after-hours, and overnight data |
| Quotes Depth | HTTP | Latest bid/ask data at specified depth, including price, quantity, and order details |
| Tick | HTTP | Tick-by-tick trade records including time, price, volume, and direction. Sorted latest first |
| Historical Bars (Single Symbol) | HTTP | OHLCV candlestick data at various granularities (M1, M5, D, etc.). Daily and above: forward-adjusted; minute bars: unadjusted |
| Historical Bars (Batch) | HTTP | Batch query for multiple symbols. Same granularity and adjustment rules as single symbol |
| Footprint | HTTP | Query the most recent N footprint records based on stock symbol, and category, time granularity. |
Instruments
| Endpoint | Protocol | Description |
|---|---|---|
| Get Instruments | HTTP | Get security information for one or more instruments |
Real-Time Streaming
| Endpoint | Protocol | Description |
|---|---|---|
| Subscribe | HTTP | Subscribe to real-time market data push via MQTT |
| Unsubscribe | HTTP | Unsubscribe from real-time market data push |
Market Data Permissions
| Market | Category | How to Access |
|---|---|---|
| US Market | Stocks, ETFs | Subscribe Nasdaq Basic (free) or Nasdaq Totalview for 50-level depth |
| US Market | Options | Subscribe OPRA Real-Time for options last sale and quotation |
| US Market | Futures | Subscribe CBOT / CME / COMEX / NYMEX individually or CME Group bundle |
| US Market | Overnight Session | Subscribe Overnight Consolidated Level 2 for real-time 50-level depth |
| US Market | Order Flow | Subscribe Order Flow for Footprint and Time Price Opportunity indicators |
| Hong Kong Market | Stocks, ETFs | LV1 data is free. For LV2 data, purchase HKEX Level 2 (Global Edition) on the Webull website |
| China Mainland | A-Shares (Stock Connect) | LV1 data is free (15-minute delay outside Mainland China; not available in Mainland China) |
caution
Market data subscriptions purchased through the Webull mobile app or desktop platform (QT) are independent of OpenAPI. You need a separate subscription specifically enabled for OpenAPI usage. Only one device may access LV1/LV2 data at any one time. For details on how to subscribe, see Subscribe Advanced Quotes.