Skip to main content

Stock Trading

The Stock Orders API supports placing, modifying, and cancelling orders for stocks and ETFs across US, HK, and A-share markets. The unified order interface handles market-specific rules automatically based on the market parameter you specify.

For options trading, see the dedicated Options page. For the full list of supported order types and features by market, see the Feature Matrix in the Trading API Overview.

Order Lifecycle​

Every order follows this lifecycle:

  1. Preview — Estimate costs and fees before committing
  2. Place — Submit the order
  3. Replace — Modify price or quantity while the order is open
  4. Cancel — Cancel a pending order
  5. Query — Check order status, history, or details at any time

Key Parameters​

ParameterRequiredDescription
account_idYesTrading account identifier
client_order_idYesUnique client-defined order ID (max 32 chars, must be unique per account)
combo_typeYesNORMAL for standard single orders
symbolYesTrading symbol (e.g., AAPL, 00700, 600519)
instrument_typeYesEQUITY for stock orders
marketYesUS, HK, or CN
order_typeYesOrder type — varies by market (see below)
sideYesBUY, SELL, or SHORT
quantityYesNumber of shares
entrust_typeYesQTY (by quantity) or AMOUNT (by cash amount, US fractional shares only)
time_in_forceYesDAY, GTC, or GTD (US only)
limit_priceConditionalRequired for LIMIT, STOP_LOSS_LIMIT, ENHANCED_LIMIT, AT_AUCTION_LIMIT
stop_priceConditionalRequired for STOP_LOSS, STOP_LOSS_LIMIT
support_trading_sessionUS onlyCORE, ALL, NIGHT, or ALL_DAY
no_party_idsHK onlyBCAN party identifiers for regulatory compliance

Supported Order Types by Market​

MarketOrder Types
USLIMIT, MARKET, STOP_LOSS, STOP_LOSS_LIMIT, MARKET_ON_OPEN, MARKET_ON_CLOSE
HKENHANCED_LIMIT, AT_AUCTION, AT_AUCTION_LIMIT
CN (A-Share)LIMIT

Request Examples — US Stock​

Buy 10 shares of AAPL at a limit price of $180, valid for the current trading day during regular hours.

{
  "account_id": "<your_account_id>",
  "new_orders": [
    {
      "client_order_id": "<unique_id>",
      "combo_type": "NORMAL",
      "symbol": "AAPL",
      "instrument_type": "EQUITY",
      "market": "US",
      "order_type": "LIMIT",
      "limit_price": "180.00",
      "quantity": "10",
      "side": "BUY",
      "time_in_force": "DAY",
      "support_trading_session": "CORE",
      "entrust_type": "QTY"
    }
  ]
}

Request Examples — HK Stock​

HK Lot Sizes

HK stocks are traded in board lots. The lot size varies by stock (e.g., Tencent 00700 = 100 shares, HSBC 00005 = 400 shares, AIA 01299 = 200 shares). Orders must be placed in multiples of the board lot. You can query the lot size via the instrument data API.

Buy 100 shares of Tencent (00700) with an enhanced limit order. HK orders require BCAN party identifiers.

{
  "account_id": "<your_account_id>",
  "new_orders": [
    {
      "client_order_id": "<unique_id>",
      "combo_type": "NORMAL",
      "symbol": "00700",
      "instrument_type": "EQUITY",
      "market": "HK",
      "order_type": "ENHANCED_LIMIT",
      "limit_price": "380.00",
      "quantity": "100",
      "side": "BUY",
      "time_in_force": "DAY",
      "entrust_type": "QTY",
      "no_party_ids": [
        {
          "party_id": "ABC123.2568",
          "party_id_source": "D",
          "party_role": "3"
        }
      ]
    }
  ]
}

Request Examples — A-Share (China Connect)​

A-share trading via Stock Connect only supports LIMIT orders.

{
  "account_id": "<your_account_id>",
  "new_orders": [
    {
      "client_order_id": "<unique_id>",
      "combo_type": "NORMAL",
      "symbol": "600519",
      "instrument_type": "EQUITY",
      "market": "CN",
      "order_type": "LIMIT",
      "limit_price": "1800.00",
      "quantity": "100",
      "side": "BUY",
      "time_in_force": "DAY",
      "entrust_type": "QTY"
    }
  ]
}
info

A-share trading is disabled by default. Contact Webull support to enable it for your account.

A-Share Price Limits

A-share prices are subject to daily limit-up / limit-down rules (typically ±10%, or ±20% for ChiNext / STAR Market stocks). Orders with a limit_price outside the allowed range will be rejected. Check the current price range before placing orders.

Combo Orders (US Only)​

In addition to standard single orders (combo_type: NORMAL), the API supports combination order types for more advanced execution strategies. Combo orders let you link multiple legs together so they execute as a coordinated group.

info

Combo orders are currently available for US stock orders only.

Take Profit / Stop Loss​

Attach a take-profit and/or stop-loss leg to a master order. The master order executes first; the TP/SL legs activate once the master is filled.

combo_typeSupported Order TypesLeg CountDescription
MASTERMARKET, LIMIT1Master order
STOP_PROFITLIMIT0–1Take-profit leg
STOP_LOSSSTOP_LOSS0–1Stop-loss leg

OTO (One Triggers Other)​

A master order that, once filled, automatically triggers one or more dependent orders.

combo_typeSupported Order TypesLeg CountDescription
MASTERMARKET, LIMIT, STOP_LOSS, STOP_LOSS_LIMIT, TOUCH_LMT, TOUCH_MKT, TRAILING_STOP_LOSS, TRAILING_STOP_LOSS_LIMIT1Master order
OTOMARKET, LIMIT, STOP_LOSS, STOP_LOSS_LIMIT1–6Triggered order(s)

OCO (One Cancels Other)​

A group of orders where filling any one leg automatically cancels the remaining legs.

combo_typeSupported Order TypesLeg CountDescription
OCOLIMIT, STOP_LOSS, STOP_LOSS_LIMIT2–6OCO legs

OTOCO (One Triggers OCO)​

A master order that, once filled, triggers an OCO group.

combo_typeSupported Order TypesLeg CountDescription
MASTERMARKET, LIMIT, STOP_LOSS, STOP_LOSS_LIMIT, TOUCH_LMT, TOUCH_MKT, TRAILING_STOP_LOSS, TRAILING_STOP_LOSS_LIMIT1Master order
OTOCOLIMIT, STOP_LOSS, STOP_LOSS_LIMIT1–6OCO legs triggered by master

Combo Order Examples​

Buy 1 share of AAPL at $176, with a stop-loss triggered at $169 (using bid price) and a take-profit limit at $279.

{
  "account_id": "<your_account_id>",
  "client_combo_order_id": "<unique_combo_id>",
  "new_orders": [
    {
      "client_order_id": "<unique_id_master>",
      "combo_type": "MASTER",
      "symbol": "AAPL",
      "instrument_type": "EQUITY",
      "market": "US",
      "order_type": "LIMIT",
      "limit_price": "176.00",
      "quantity": "1",
      "side": "BUY",
      "time_in_force": "DAY",
      "support_trading_session": "ALL",
      "entrust_type": "QTY"
    },
    {
      "client_order_id": "<unique_id_sl>",
      "combo_type": "STOP_LOSS",
      "symbol": "AAPL",
      "instrument_type": "EQUITY",
      "market": "US",
      "order_type": "STOP_LOSS",
      "stop_price": "169.00",
      "trigger_price_type": "PRICE_BID",
      "quantity": "1",
      "side": "SELL",
      "time_in_force": "DAY",
      "support_trading_session": "ALL",
      "entrust_type": "QTY"
    },
    {
      "client_order_id": "<unique_id_tp>",
      "combo_type": "STOP_PROFIT",
      "symbol": "AAPL",
      "instrument_type": "EQUITY",
      "market": "US",
      "order_type": "LIMIT",
      "limit_price": "279.00",
      "quantity": "1",
      "side": "SELL",
      "time_in_force": "DAY",
      "support_trading_session": "ALL",
      "entrust_type": "QTY"
    }
  ]
}

What's Next​