Market Data API Overview
The Market Data API provides real-time and historical market data through 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 | Overnight Session | ✓ |
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 |
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 |
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.