About Connect API
The Webull Connect API enables third-party platforms to integrate with Webull brokerage accounts using the OAuth 2.0 protocol. Through the Connect API, partners can build applications that allow their users to securely access Webull trading services — including account management, order placement, and position queries — directly from their own platforms.
Who Is It For?
If you are a third-party financial trading platform (e.g., TradingView or SnapTrade) and you want your customers to manage their Webull accounts directly on your platform, then the Connect API is the right choice.
How It Works
The Connect API uses OAuth 2.0 for authentication. The integration flow is:
- Your user clicks "Connect Webull" in your application
- They are redirected to Webull's login page to authorize access
- Webull redirects back to your application with an authorization code
- Your server exchanges the code for an access token
- Use the access token to call Trading API endpoints on behalf of the user
OAuth 2.0 and Trading API
The Connect API integration consists of two parts:
-
OAuth 2.0 Authentication — Complete user authorization to obtain an access token. This allows Webull customers to securely grant your platform access to their accounts. See the OAuth Security Authentication Module for details.
-
Trading API — Once authenticated, use the access token to perform operations such as querying account balances, checking positions, and placing orders. See the Trading API Module for details.
The Connect API and Trading API share identical functionality across the Account, Assets, and Orders modules. The only difference is the base URL — Connect API requests go through the OAuth endpoint instead of the standard API endpoint.
Supported Features
Supported instruments include US stocks, options, futures, crypto, and event contracts.
| Module | Description |
|---|---|
| Authorization | OAuth 2.0 authentication and user authorization |
| Account | Query account list and information |
| Assets | Query account balance and positions |
| Orders | Retrieve tradable securities, preview, place, modify, and cancel orders |
Base URLs
| Environment | Service | URL |
|---|---|---|
| Test (UAT) | Authorization Login Redirect (H5) | passport.uat.webullbroker.com |
| Test (UAT) | Authorization, Account, Trading API | us-oauth-open-api.uat.webullbroker.com |
| Production | Authorization Login Redirect (H5) | passport.webull.com |
| Production | Authorization, Account, Trading API | us-oauth-open-api.webull.com |
Getting Started
Step 1: Register Your Application
Contact the Webull API team at api@webull-us.com to register your application. You'll need to provide:
- Your company name
- Redirect URL for OAuth callbacks
Step 2: Receive Credentials
After registration, you'll receive your application credentials including Client ID and Client Secret.
Step 3: Complete UAT Testing
Integrate with the test environment and validate your OAuth flow and trading operations.
Step 4: Go Live
Once UAT testing is approved, switch to the production base URLs to go live.
For detailed instructions on implementing the OAuth 2.0 flow, see the OAuth Integration Guide.
Contact Us
For registration, technical questions, or integration support, reach out to the Webull API team: