Trading API Overview
The Trading API lets you manage accounts, place and manage orders, and receive real-time order status updates — all programmatically. It supports stocks and single-leg options trading.
tip
The Webull SDK simplifies integration by handling authentication and protocol details. See SDKs and Tools for installation.
Supported Products
| Product | Description | Details |
|---|---|---|
| Stocks | US Equities | Stocks |
| Single-Leg Options | US Single-Leg Options | Single-Leg Options |
Feature Matrix
✓ = Supported, X = Not yet supported (may be added in the future), - = Not applicable
| Feature | US Stocks | US Single-Leg Options |
|---|---|---|
| Market Order | ✓ | ✓ |
| Limit Order | ✓ | ✓ |
| Stop Loss | ✓ | ✓ |
| Stop Loss Limit | ✓ | ✓ |
API Reference
Instruments
| Endpoint | Rate Limit | Description |
|---|---|---|
| Stock Instruments | 10/30s | Retrieve instrument details for given stock symbols |
Account
| Endpoint | Rate Limit | Description |
|---|---|---|
| Account List | 10/30s | Retrieve all accounts under your credentials |
| Account Balance | 2/2s | Query balance, buying power, and cash details |
| Account Positions | 2/2s | Retrieve current holdings and positions |
Orders
| Endpoint | Rate Limit | Description |
|---|---|---|
| Preview Order | 150/10s | Estimate costs before placing an order |
| Place Order | 600/60s | Submit orders for stocks and single-leg options |
| Replace Order | 600/60s | Modify an existing open order |
| Cancel Order | 600/60s | Cancel a pending or open order |
| Order History | 2/2s | Query historical order records |
| Open Orders | 2/2s | Retrieve current open orders |
| Order Detail | 2/2s | Get detailed info for a specific order |
Real-Time Events
| Endpoint | Protocol | Description |
|---|---|---|
| Trade Event Subscription | gRPC | Subscribe to live order status changes (filled, cancelled, failed, etc.) |
What's Next
- Trading API Getting Started — Make your first trade in 5 steps
- Accounts — Query balances and positions
- Orders — Stock order management
- Single-Leg Options — Single-leg options order management