Change Logs
2026-06-13
Signature document update.
Gainers & Losers API returns update.
Top Active Screener endpoint has been renamed.
Changed
| Category | API | Change | Link |
|---|---|---|---|
| Docs | — | Signature document content updated by part format. | Signature |
| API | Market Data API | Gainers & Losers endpoint response added relative_volume_10d field. | Gainers & Losers |
| API | Market Data API | Screener endpoint name and URL changed from most-active to top-active. | Top Active |
2026-06-06
Trading API & Broker API: Stock Instrument endpoints added margin requirement ratio fields.
Changed
| Category | API | Change | Link |
|---|---|---|---|
| API | Trading API | Get Stock Instrument response now returns four additional margin fields:intraday_margin_long — Intraday margin requirement ratio for long positionintraday_margin_short — Intraday margin requirement ratio for short positionmaintenance_margin_long — Maintenance margin requirement ratio for long positionmaintenance_margin_short — Maintenance margin requirement ratio for short position | Get Stock Instrument |
| API | Broker API | Broker API Get Stock Instrument response now returns four additional margin fields:intraday_margin_long — Intraday margin requirement ratio for long positionintraday_margin_short — Intraday margin requirement ratio for short positionmaintenance_margin_long — Maintenance margin requirement ratio for long positionmaintenance_margin_short — Maintenance margin requirement ratio for short position | Get Stock Instrument |
2026-05-30
Broker API account opening capabilities significantly expanded. New endpoints added across Authentication and Market Data API
New
| Category | API | Change | Link |
|---|---|---|---|
| API | Authentication | Added Client-To-Server authentication flow with two new endpoints: Create Client Token and Refresh Client Token | Create Client Token · Refresh Client Token |
| API | Market Data API | Added Display Solution tier under Market Data API, including Stock Screener (Top Active, Top Gainers/Losers), Stock Quotes (Snapshot, Historical Bars, Tick, Quotes Depth, Historical Bars single symbol), Corporate Actions (By Market, Detail), Stock Instrument (Get Instruments, Batch Get Logos, Company Profile, Analyst Target Price, Analyst Rating), Event Contract market data (Instrument: Sports Filter, Series List, Milestones, Event List, All Tags; Quotes: Snapshot, Depth, Bars by Symbols, Bars by Event, Live Data, Game Stats), and Streaming (Subscribe, Unsubscribe) | Display Solution |
| API | Market Data API | Added Option market data endpoints under Non-Display Solution: Option Tick, Option Snapshot, Option Historical Bars | Option Tick · Option Snapshot · Option Historical Bars |
| API | Broker API – Accounts | Added Retrieve Account List endpoint (GET /accounts) | Retrieve Account List |
Changed
| Category | API | Change | Link |
|---|---|---|---|
| API | Broker API – Accounts | Create an Account: now supports submitting Basic Form + Brokerage Form + EC Form simultaneously to open both a Brokerage account and an EC account in a single request | Create an Account |
| API | Broker API – Accounts | Create an Account: supports opening a Brokerage or EC account first, then appending additional account types by passing related_account_id + additional form in a subsequent New Account request | Create an Account |
| API | Broker API – Accounts | Create an Account (EC additional form) and Update an Account: added new optional field is_bp_shared (boolean) | Create an Account · Update an Account |
2026-05-16
Trading API order events now include
order_id. New MCP tools and Skills endpoints added. Broker API agreement types expanded. Order quantity precision updated.
New
| Category | API | Change | Link |
|---|---|---|---|
| MCP | Market Data API | Added new MCP tools: get_stock_noii_bars, get_stock_noii_snapshot, get_gainers_losers, get_most_active | MCP |
| MCP | Trading API | Added new MCP tools: get_futures_instruments, get_futures_products, get_futures_product_class, get_company_profile, get_analyst_rating, get_analyst_target_price, get_watchlists, create_watchlist, update_watchlist, delete_watchlist, get_watchlist_instruments, add_watchlist_instruments, remove_watchlist_instruments, update_watchlist_instruments | MCP |
| Skills | Market Data API | Added new Skills endpoints: stock-noii-bars, stock-noii-snapshot, stock-gainers-losers, stock-most-active | Skills |
| Skills | Trading API | Added new Skills endpoints: instrument-company-profile, instrument-analyst-rating, instrument-analyst-target-price, instrument-futures-product-class, instrument-futures-products, instrument-futures-list, watchlist-list, watchlist-create, watchlist-delete, watchlist-update, watchlist-instruments-list, watchlist-instruments-add, watchlist-instruments-remove, watchlist-instruments-update | Skills |
Changed
| Category | API | Change | Link |
|---|---|---|---|
| API | Trading API | Subscribe Trade Events: response now includes order_id field | Subscribe Trade Events |
| API | Trading API | Order History, Open Order, Order Detail: response fields total_quantity and filled_quantity precision updated to 5 decimal places | Order History · Open Order · Order Detail |
| API | Broker API | Get Form Content: added three new mandatory agreement types for account opening — DAY_TRADING_RISK_DISCLOSURE, EXTENDED_HOURS_TRADING_DISCLOSURE, LOW_PRICED_SECURITIES_ALERT | Get Form Content |
| Docs | — | SDK page updated with Broker API host information | SDKs and Tools |
2026-04-04
AI assistants can now access Webull trading and market data via Model Context Protocol (MCP).
New
| Category | Change | Link |
|---|---|---|
| Docs | Added Webull MCP Server documentation — step-by-step setup guide for connecting AI assistants to Webull OpenAPI via Model Context Protocol, including architecture overview, prerequisites, client configuration, authentication flow, available endpoints, and security recommendations | Webull MCP Server |
2026-03-28
Event contracts now support real-time market data streaming.
Order Place endpoint: added
position_intentfield for options orders.
Changed
| Category | Change | Link |
|---|---|---|
| Docs | Event contracts now support quote, snapshot, and tick data subscription in the Data Streaming API | Data Streaming API |
| API | Order Place endpoint added position_intent field for options orders. Supported values: BUY_TO_OPEN, BUY_TO_CLOSE, SELL_TO_OPEN, SELL_TO_CLOSE. For combo orders, it can only be set on the MASTER order. | Order Place |
2026-03-14
API Reference
Market Data API
- Added two new endpoints to the event market module:
Trading API
-
Added two new endpoints to the Instrument module:
-
Updated Get Event Contract Series:
- Request: Renamed parameter
last_instrument_idtolast_series_id; addedsymbolsparameter. - Response: Renamed field
instrument_idtoseries_id.
- Request: Renamed parameter
-
Updated Get Event Contract Instrument:
- Request: Added
event_symbol,symbols, andexpiration_date_afterparameters. - Response: Added
event_symbolandevent_namefields.
- Request: Added
2026-03-07
API Reference
Fractional Event Contract New Feature Support
- Trading Module : Now supports order placement for fractional event contracts
- Get Event Contract Instrument Endpoint: Added dedicated fields for fractional event contract support and price range parameters of event contracts
fractionable: Boolean field indicating whether the event contract instrument supports fractional tradingpriceRanges: Field defining the price range parameters for the event contract instrument
2026-01-31
Documentation
- Added the Event Trading documentation to the Trading API module.
API Reference
Market Data API
- Added two new interfaces, Event Snapshot and Event Depth, to the event market module.
Trading API
- Enhanced the interface capabilities of the Trading module, including support for event contracts and the addition of algorithmic order trading functionality (TWAP, VWAP, POV).
2026-01-17
Documentation
-
Added About Connect API documentation under the Connect API module, providing an overview of the Connect API framework, its purpose, and core capabilities.
-
Added Authorization and Trading in Connect API documentation under the Connect API module, detailing the end-to-end authorization flow and how trading operations are performed using Connect API.
API Reference
Market Data API
-
Added a new endpoint: Footprint Connect API
-
Added Get An Authorization Code API documentation, describing how to obtain an authorization code as part of the OAuth authorization process.
-
Added Create And Refresh Token API documentation, covering access token creation and token refresh mechanisms.
2026-01-12
API Reference Updates
Market Data API
-
RESTful API
- Updated the response format for market data snapshots: For the latest response schema, see: Snapshot
-
Data Streaming
- Enhanced the fields included in market data snapshot streaming.
For the latest payload definition, see: Snapshot
- Enhanced the fields included in market data snapshot streaming.
Trading API
- Orders
- Added a new endpoint: Order Batch Place
2025-12-13
Now supporting futures and crypto trading!
1. Documentation
2. API Reference
-
Description:
- Market Data: Added futures and crypto market data interface. Supports market snapshot, historical bars, data etc.
- Trading: Building on our existing trading APIs, we have launched a more powerful suite of trading interfaces (covering order estimate, place, replace, and cancel). Now, a single order place API enables trading across stocks, options, futures, and crypto.
- Accounts & Assets: Now supporting futures and cryptocurrency accounts and assets.
-
Interface:
- Market Data API:
- Futures: Tick, snapshot,depth of book,historical bars
- Crypto: snapshot,historical bars
- Trading API:
- Accounts: Account List
- Assets: Account Balance, Account Positions
- Orders:
- Futures: Order Preview, Order Place, Order Replace, Order Cancel
- Crypto: Order Place, Order Cancel
- Market Data API:
2025-11-29
Documentation
- Added code examples for the Assets, Accounts, and Orders modules in the documentation.
- Fixed broken links in the documentation.
2025-11-20
Documentation Initialization
Core Description
- Create the Webull official Open API documentation for the first time to provide developers with complete interface integration specifications, usage guides, and technical references.
- Document Purpose: For developers to integrate with Webull Open API and query interface details
- Document Structure: Divided into three core modules: "Documentation", "API Reference", and "Recipes"
Coverage
1. Documentation
- Description: Welcome、About Webull、About Webull OpenAPI
- Development Tools: SDKs and Tools、Additional Resources
- Core Modules:
- Authentication: Overview 、Individual Application Process、Signature、Token
- Market Data API: Overview、Getting Started、Data API、Data Streaming API、FAQ
- Trading API: Overview、Getting Started、Account API、Trading API、Trading Events、FAQ
- Connect API: Under construction
- Broker API: Under construction
- Supplementary Content: Q&A
2. API Reference
- Description: Webull Open API Reference
- Authentication:
- Document: Token
- interface: Create Token(POST)、Check Token(POST)
- Market Data API:
- Document: Getting Started
- Stock:
- Basic interface: Tick(GET)、Snapshot(GET)、Quotes(GET)、Historical Bars(POST)、Historical Bars (single symbol)(GET)
- Streaming Interface: Subscribe(POST)、Unsubscribe(POST)
- Trading API:
- Document: Getting Started
- Utility interface: Instrument(GET)
- Account interface: Account List(GET)、Account Balance(GET)、Account Positions(GET)
- Order interface:
- Stock order: Preview Order(POST)、Place Order(POST)、Replace Order(POST)、Cancel Order(POST)
- Option order: Preview Options(POST)、Place Options(POST)、Modify Options(POST)、Cancel Options(POST)
- Order Query: Order History(GET)、Open Order(GET)、Order Detail(GET)
- Trade Events: Subscribe Trade Events
3. Recipes
- Signature Generation
- Create and verify token
- Place your first order