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.
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 | ✓ |
| US | Overnight Session | ✓ |
| US | Futures (CME Group) | ✓ |
| US | Crypto | ✓ |
| US | Event Contracts | ✓ |
Available Endpoints
The Market Data API covers the following categories. For a complete and up-to-date list of endpoints, refer to the API Reference.
Market Data Permissions
| Market | Category | How to Access |
|---|---|---|
| US Market | Stocks, ETFs | Subscribe Nasdaq Basic (Level 1) or Nasdaq Totalview (Level 2) for Non-Display OpenAPI usage |
| US Market | Options | Subscribe OPRA Real-Time Non-display for options last sale and quotation |
| US Market | Futures | Subscribe CBOT / CME / COMEX / NYMEX individually or CME Group bundle for futures data |
| US Market | Overnight Session | Subscribe Overnight Consolidated Level 2 for real-time 50-level depth |
| US Market | Order Flow | Subscribe Order Flow Non-display for Footprint and Time Price Opportunity indicators |
| US Market | Crypto | No additional subscription required |
| US Market | Event Contracts | No additional subscription required |
For market data that requires an additional subscription, the sandbox environment provides 15-minute delayed data by default. If you have subscribed to real-time market data in the production environment, the sandbox environment will also be upgraded to provide real-time data accordingly.
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.