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.

What's Next​