# 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:

1. Your user clicks "Connect Webull" in your application
2. They are redirected to Webull's login page to authorize access
3. Webull redirects back to your application with an authorization code
4. Your server exchanges the code for an access token
5. 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:

1. **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](../reference/connect-api/connect.tag.mdx) for details.

2. **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](../reference/custom/trading-api.tag.md) for details.

:::info
The Connect API and Trading API expose related account and trading capabilities through different authentication and service endpoints. Follow the Connect API authentication flow and use only the resource paths and headers documented for your Connect integration.
:::

## Supported Features

Supported instruments include US stocks, options, futures, crypto, and event contracts, subject to the permissions granted to the Connect application.

| Module | Description |
|--------|-------------|
| [Authorization](../reference/connect-api/connect.tag.mdx) | OAuth 2.0 authentication and user authorization |
| [Account](../reference/accounts.tag.mdx) | Query account list and information |
| [Assets](../reference/assets.tag.mdx) | Query account balance and positions |
| [Orders](../reference/custom/order.tag.mdx) | Retrieve tradable securities, preview, place, modify, and cancel orders |

## Service Endpoints

| Environment | Service | Hostname | Path |
|-------------|---------|----------|------|
| Sandbox | Authorization Login Redirect (H5) | `passport.webull.com` | `/oauth2/sandbox/authenticate/login` |
| Sandbox | Authorization, Account, Trading API | `oauth-open-api.sandbox.webull.com` | — |
| Production | Authorization Login Redirect (H5) | `passport.webull.com` | `/oauth2/authenticate/login` |
| Production | Authorization, Account, Trading API | `us-oauth-open-api.webull.com` | — |

The Authorization Login Redirect (H5) shares the same hostname across environments and uses the path to distinguish Sandbox from Production. The API endpoints are separated by hostname and do not require path-based routing.

## Getting Started

### Step 1: Submit Your Application

Submit your application through the [Application Form](https://www.webull.com/connect-api/info). You'll need to provide:
- Your company name
- Redirect URL for OAuth callbacks

Once submitted, our business team will reach out to you.

### Step 2: Receive Your Integration Details

After your application is approved, we'll send you the integration details, including your Client ID and Client Secret.

### Step 3: Complete Sandbox Testing

Integrate with the sandbox environment and validate your OAuth flow and trading operations.

### Step 4: Go Live

Once sandbox testing is approved, switch to the production service endpoints to go live.

For detailed instructions on implementing the OAuth 2.0 flow, see the [OAuth Integration Guide](authentication.md).

## Rate Limits

We implement rate limits to ensure that the API remains responsive for all clients. The configuration of these rate limits is designed to provide sufficient capacity while preventing abnormal usage.

Rate limits are applied at the individual user level for authorized logins.

The frequency of all API requests for a single user must be less than 90 requests per minute.

## Contact Us

For registration, technical questions, or integration support, reach out to the Webull API team:
- [connect.api@webull-us.com](mailto:connect.api@webull-us.com)