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, options, futures, crypto, and event contracts.
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 (NYSE, NASDAQ), fractional shares, short selling | Orders |
| Options | Single-leg and multi-leg strategies (Covered Stock, Vertical, Iron Condor, etc.) | Orders |
| Futures | Index, interest rate, currency, agriculture, metals, energy, crypto futures | Futures |
| Crypto | 70+ crypto assets, spot trading 24/7 | Crypto |
| Event Contracts | Binary outcome contracts across economics, politics, sports, and more | Event Contracts |
Feature Matrix
✓ = Supported, X = Not yet supported (may be added in the future), - = Not applicable
| Feature | Stocks | Options | Futures | Crypto | Event Contracts |
|---|---|---|---|---|---|
| Market Order | ✓ | X | ✓ | ✓ | - |
| Limit Order | ✓ | ✓ | ✓ | ✓ | ✓ |
| Stop Loss | ✓ | ✓ | ✓ | X | - |
| Stop Loss Limit | ✓ | ✓ | ✓ | ✓ | - |
| Trailing Stop Loss | ✓ | X | ✓ | X | - |
| Fractional Shares | ✓ | - | - | ✓ | ✓ |
| Short Selling | ✓ | - | - | - | - |
| Combo Orders (OTO/OCO/OTOCO) | ✓ | ✓ | X | X | - |
| Take-Profit / Stop-Loss | ✓ | ✓ | X | X | - |
| Algo Orders (TWAP/VWAP/POV) | ✓ | X | X | X | X |
| Extended Hours Trading | ✓ | - | - | - | - |
| Overnight Session | ✓ | - | - | - | - |
| 24/7 Trading | - | - | - | ✓ | - |
| Near 24/6 Trading | - | - | ✓ | - | - |
API Reference
Instruments
| Endpoint | Rate Limit | Description |
|---|---|---|
| Stock Instruments | 10/30s | Retrieve instrument details for given stock symbols |
| Futures Products | 10/30s | List available futures product categories |
| Futures Contracts (by Symbol) | 10/30s | Query futures contracts by symbol |
| Futures Contracts (by Code) | 10/30s | Query futures contracts by product code |
| Crypto Instruments | 10/30s | List available crypto trading pairs |
| Event Contract Series | — | List available event contract series |
| Event Contract Instruments | — | Query event contract details |
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, options, futures, or crypto |
| Batch Place Orders | 600/60s | Submit multiple orders in a single request |
| 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 and options order management