Market Data API Overview
The Market Data API provides access to real-time and historical market data for US stocks, ETFs, futures, crypto, and event contracts. 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 | Webull Users |
|---|---|---|
| US | Stocks & ETFs | ✓ |
| US | Options | X |
| US | Overnight Session | ✓ |
| US | Futures (CME Group) | ✓ |
| US | Crypto | ✓ |
| US | Event Contracts | ✓ |
Available Endpoints
Stock Data
| Endpoint | Protocol | Description |
|---|---|---|
| Tick | HTTP | Tick-by-tick transaction records for a specified time range |
| Snapshot | HTTP | Real-time market snapshot with latest price, change, and volume |
| Quotes | HTTP | Order book data at specified depth (price, quantity, orders) |
| Footprint | HTTP | Order flow and volume profile analysis |
| Historical Bars (Single Symbol) | HTTP | OHLCV candlestick data at various granularities (M1, M5, D, etc.) |
| Historical Bars (Batch) | HTTP | Batch OHLCV query for multiple symbols |
Futures Data
| Endpoint | Protocol | Description |
|---|---|---|
| Tick | HTTP | Tick-by-tick trade data for futures contracts |
| Snapshot | HTTP | Real-time snapshot with latest price and open interest |
| Depth of Book | HTTP | Market depth data for futures contracts |
| Footprint | HTTP | Futures order flow and volume profile |
| Historical Bars | HTTP | Historical OHLCV data for futures contracts |
Crypto Data
| Endpoint | Protocol | Description |
|---|---|---|
| Snapshot | HTTP | Real-time snapshot for up to 20 crypto symbols |
| Historical Bars | HTTP | Historical candlestick data across multiple intervals |
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 |
Rate Limits
| API Type | Limit |
|---|---|
| Data API (HTTP) | 300 requests per 60 seconds |
| Streaming (Subscribe/Unsubscribe) | No rate limit |
Market Data Permissions
| Market | Category | How to Access |
|---|---|---|
| US Market | Stocks, ETFs, Overnight Session | Purchase Level 1 and/or Level 2 market data subscriptions for OpenAPI |
| US Market | Futures | Purchase OpenAPI market data subscription |
| US Market | Crypto | No additional subscription required |
| US Market | Event Contracts | No additional subscription required |
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.