Trading API Overview
The Trading API lets you manage accounts, place and manage orders, and receive real-time order status updates 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.) | Options |
| Futures | Index, interest rate, currency, agriculture, metals, energy, and crypto futures | Futures |
| Crypto | Crypto spot trading | Crypto |
| Event Contracts | Binary outcome contracts across economics, politics, sports, and more | Event Contracts |
Feature Matrix
✓ = Supported, X = Not supported, — = Not applicable. Some features depend on account permissions and the selected order mode.
| Feature | Stocks | Options | Futures | Crypto | Event Contracts |
|---|---|---|---|---|---|
| Market / best-available-price execution | ✓ | ✓ | ✓ | ✓ | ✓* |
| Limit Order | ✓ | ✓ | ✓ | ✓ | ✓ |
| Stop Loss | ✓ | ✓ | ✓ | X | — |
| Stop Loss Limit | ✓ | ✓ | ✓ | ✓ | — |
| Trailing Stop Loss | ✓ | X | ✓ | X | — |
| Fractional quantity | ✓ | — | — | ✓ | ✓ |
SHORT order side | ✓ | ✓ | — | — | — |
| OTO/OCO/OTOCO | ✓ | X | X | X | — |
| Take-Profit / Stop-Loss combinations | ✓ | ✓** | X | X | — |
| Algo Orders (TWAP/VWAP/POV) | ✓ | X | X | X | X |
| Extended Hours Trading | ✓ | — | — | — | — |
| Overnight Session | ✓ | — | — | — | — |
| 24/7 Trading | — | — | — | ✓ | — |
| Near 24/6 Trading | — | — | ✓ | — | — |
* Event contracts select best-available-price execution with event_trade_mode; order_type remains LIMIT.
** Options support MASTER, STOP_PROFIT, and STOP_LOSS only for supported SINGLE strategy scenarios. OTO/OCO/OTOCO are equity-only.
See the product-specific pages for conditional parameter rules.
API Reference
Instruments
| Endpoint | Rate Limit | Description |
|---|---|---|
| Stock Instruments | 60/60s | Retrieve instrument details for stock symbols |
| Futures Product Codes | 60/60s | List available futures products and product codes |
| Futures Contracts | 60/60s | Query futures contracts by symbol |
| Crypto Instruments | 60/60s | List available crypto trading pairs |
| Event Contract Series | 60/60s | List available event contract series |
| Event Contract Instruments | 60/60s | 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, crypto, or event contracts |
| Batch Place Orders | 150/60s | Submit multiple orders in a single batch 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 information for an order |
Real-Time Events
| Endpoint | Protocol | Description |
|---|---|---|
| Trade Event Subscription | gRPC | Subscribe to live order status changes |
What's Next
- Trading API Getting Started — Make your first trade
- Accounts — Query balances and positions
- Stock Orders — Stock and ETF order management
- Options — Single-leg and multi-leg options