Skip to main content

Stock Trading

The Stock Orders API supports placing, modifying, and cancelling orders for stocks and ETFs on the US market.

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

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)
instrument_typeYesEQUITY for stock orders
marketYesUS
order_typeYesOrder type — see table below
sideYesBUY or SELL
quantityYesNumber of shares
entrust_typeYesQTY (by quantity)
time_in_forceYesDAY or GTC
limit_priceConditionalRequired for LIMIT, STOP_LOSS_LIMIT
stop_priceConditionalRequired for STOP_LOSS, STOP_LOSS_LIMIT

Supported Order Types

Order TypeDescription
MARKETExecute immediately at the best available price
LIMITExecute at the specified price or better
STOP_LOSSTrigger a market order when the stop price is reached
STOP_LOSS_LIMITTrigger a limit order when the stop price is reached

Time in Force

ValueDescription
DAYValid for the current trading day only
GTCGood till cancelled — remains active until filled or manually cancelled

What's Next