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, single-leg options, and multi-leg option strategies.
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, JP Equities | Stocks |
| Options | US single-leg options and multi-leg strategies (Vertical, Straddle, Iron Condor, etc.) | Options |
Feature Matrix
✓ = Supported, X = Not yet supported (may be added in the future), - = Not applicable
| Feature | US Stocks | JP Stocks | US Single-Leg Options | US Multi-Leg Options |
|---|---|---|---|---|
| Market Order | ✓ | ✓ | ✓ | ✓ |
| Limit Order | ✓ | ✓ | ✓ | ✓ |
| Stop Loss | ✓ | ✗ | ✓ | ✓ |
| Stop Loss Limit | ✓ | ✗ | ✓ | ✓ |
| Leg In / Leg Out | - | - | - | ✓ |
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, single-leg options, and multi-leg option strategies |
| Replace Order | 600/60s | Modify an existing open order (including multi-leg option orders) |
| 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
- Options — Single-leg and multi-leg options order management