About Broker API

This documentation introduces our Broker API, built to help developers and businesses create tailored trading platforms and full brokerage services for their users.

If you're mainly interested in building personal trading bots, automated strategies or algorithmic tools, please check out our separate Trading API documentation instead.

Webull's Broker API enables you to offer a complete brokerage experience — covering everything from user onboarding and account opening, through funding & withdrawals, to live trading and portfolio management. This reference contains all the endpoints, flows, and best practices needed to integrate and operate your platform.

Broker API Use Cases

The Broker API is flexible and supports multiple business models and integration patterns. Here are some of the most common ways companies are using it (this list is not exhaustive — contact our business team if your idea falls outside these categories):

• Fully-disclosed broker-dealer model (Coming Soon)
• Omnibus with Virtual Account model

The exact API capabilities you will use heavily depend on your chosen model. For example:

• In fully-disclosed models, you would use the account opening, funding, and KYC-related endpoints extensively.
• In Omnibus with Virtual Account models, you would focus on virtual account setup, instant funding, and virtual account position and balance tracking endpoints.

Account Model Comparison

Function	Fully Disclosed	Omnibus with Virtual Account
Client Data	Individual client data is disclosed to Webull as the clearing broker.	Only the omnibus account is fully visible. Webull has partial visibility into virtual accounts including transactions, positions, and cash, enabling faster processing such as corporate actions.
Account Structure	Individual accounts per customer, opened and maintained at Webull.	Single omnibus account with virtual sub-accounts created via API to track end-customers.
Order Placement	Placed at the individual customer level.	Placed at the virtual account level and observable at the omnibus level.
Position Management	Individual customer positions managed by Webull.	Virtual account level positions and aggregate omnibus level positions.
Corporate Actions	Processed by Webull for each individual account.	Processed by Webull at both the omnibus and virtual account levels.
Reconciliation	Straightforward. Individual account level data available.	Simplified. Virtual account level data available for easy verification.
Buying Power Control	Individual account level.	Supports both omnibus account level
Scalability	High. Each new client adds a new account.	High. Add thousands of virtual accounts via API without increased operational overhead.
Operational Burden	Low. Webull handles back-office, custody, and record-keeping.	Low to Medium. Webull's API automates much of the sub-accounting process, significantly reducing manual effort.