Place Strategy Order

Description

Place a strategy order

• API Broker rebate identifier:
  The following code block needs to be added to the HTTP Header of the request.

  "X-CHANNEL-API-CODE":"your-channel-api-code"

HTTP Request

• POST /api/v3/trade/place-strategy-order
• Speed limit is 10 times/s (UID)
• Permission: UTA trade (read & write)

Request

curl -X POST "https://api.bitget.com/api/v3/trade/place-strategy-order" \
  -H "ACCESS-KEY:your apiKey" \
  -H "ACCESS-SIGN:*" \
  -H "ACCESS-PASSPHRASE:*" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:zh-CN" \
  -H "Content-Type: application/json" \
  -d '{ "category": "usdt-futures","symbol": "BTCUSDT","posSide": "long","stopLoss": "99000","takeProfit": "100800","clientOid": "121211212122"}'

Common Request Parameters

These fields apply to every strategy type. The parameters specific to each strategy type are listed separately in the sections below.

Parameter	Type	Required	Comments
category	String	Yes	Product type SPOT Spot MARGIN Margin USDT-FUTURES USDT futures COIN-FUTURES Coin-M futures USDC-FUTURES USDC futures
symbol	String	Yes	Symbol name e.g.,BTCUSDT
type	String	No	Strategy Type tpsl Take-Profit and Stop-Loss trigger Trigger Order oco OCO trailing_stop Trailing Stop iceberg Iceberg twap TWAP Default:tpsl
side	String	No	Trade side buy/sell Hedge-mode: Open long: side=buy & posSide=long Open short: side=sell & posSide=short Close long: side=sell & posSide=long Close short: side=buy & posSide=short One-way mode: Open long: side=buy Open short: side=sell Close long: side=sell & reduceOnly=yes Close short: side=buy & reduceOnly=yes
posSide	String	No	Position side long/short
qty	String	No	Order Quantity
clientOid	String	No	Client order ID Only valid when type=tpsl; not supported for other strategy types

Strategy Type

Bitget UTA supports the following strategy order types via the type parameter. Not every strategy type is available on every product line — check the support matrix below before placing an order.

type	Description	SPOT	MARGIN	USDT-FUTURES	COIN-FUTURES	USDC-FUTURES
tpsl	Take-Profit and Stop-Loss	✅	✅	✅	✅	✅
trigger	Trigger Order	✅	✅	✅	✅	✅
oco	OCO (One-Cancels-the-Other)	✅	✅	❌	❌	❌
trailing_stop	Trailing Stop	✅	❌	✅	❌	✅
iceberg	Iceberg Order	✅	❌	✅	❌	✅
twap	TWAP (Time-Weighted Average Price)	✅	❌	✅	❌	✅

Take-Profit and Stop-Loss (type=tpsl)

Attach take-profit and/or stop-loss protection to an existing position. When the market (or mark) price reaches the configured trigger price, Bitget submits a limit or market order on your behalf to close the position.

Parameter	Type	Required	Comments
tpslMode	String	No	Take-Profit and Stop-Loss Mode fullAll Positions Take-Profit and Stop-Loss partialPartial Position Take-Profit and Stop-Loss If left blank, the default value is full
qty	String	No	Order Quantity Required when tpslMode=partial. Unit is in the base coin
reduceOnly	String	No	Whether it is reduce-only yes/no
tpTriggerBy	String	No	Take-Profit Trigger Type market: Market Price mark: Mark Price If not specified, the default value is market price
slTriggerBy	String	No	Stop-Loss Trigger Type market: Market Price mark: Mark Price If not filled in, the default value is market price
takeProfit	String	No	Take-Profit Trigger Price
stopLoss	String	No	Stop-Loss Trigger Price
tpOrderType	String	No	Take-Profit Trigger Strategy Order Type limit: Limit Order market: Market Order If not filled in, the default value is market price
slOrderType	String	No	Stop-Loss Trigger Strategy Order Type limit: Limit Order market: Market Order If not filled in, the default value is market price
tpLimitPrice	String	No	Take-Profit Strategy Order Execution Price This field is only valid for limit orders (when tpOrderType=limit); it is ignored for market orders.
slLimitPrice	String	No	Stop-Loss Strategy Order Execution Price This field is only valid for limit orders (when slOrderType=limit); it is ignored for market orders

Trigger Order (type=trigger)

Place a single conditional order that only submits to the order book once the market reaches your trigger price — useful for breakout entries or stop-loss entries without holding a position yet.

Parameter	Type	Required	Comments
qty	String	No	Order Quantity Required for trigger orders. Unit is in the base coin
reduceOnly	String	No	Whether it is reduce-only yes/no
triggerBy	String	No	Trigger order trigger price type market: Market Price mark: Mark Price If not specified, the default value is market price
triggerPrice	String	No	Trigger order trigger price Only valid for limit orders (when triggerOrderType=limit); ignored for market orders
triggerOrderType	String	No	Trigger order type limit: Limit Order market: Market Order
triggerOrderPrice	String	No	Trigger order execution price Only valid for limit orders (when triggerOrderType=limit); ignored for market orders

OCO (type=oco)

OCO (One-Cancels-the-Other) places two orders at once — a direct limit order and a conditional (trigger) order — as a single pair. Whichever leg fills or triggers first automatically cancels the other, letting you set a take-profit/bottom-fishing limit and a chase-up/stop-loss trigger in one request.

Parameter	Type	Required	Comments
ocoParams	List<String>	Yes	OCO parameters list
>ocoLimitPrice	String	Yes	Limit order price for OCO side=buy: limit buy price (bottom fishing) side=sell: limit sell price (take-profit) Applied to the non-triggered direct limit order
>ocoTriggerPrice	String	Yes	Trigger price for the conditional order leg side=buy: chase-up trigger price side=sell: stop-loss trigger price Applied to the triggered conditional order leg
>ocoOrderType	String	Yes	Order type for the conditional order leg limit: Limit Order market: Market Order
>ocoOrderPrice	String	No	Execution price for the conditional order leg side=buy: chase-up price side=sell: stop-loss price Required when ocoOrderType=limit

Trailing Stop (type=trailing_stop)

Trailing stop dynamically follows the market price by a fixed ratio or spread once activated, then submits a preset order when the price pulls back by that trailing distance — allowing you to lock in profit as the market keeps moving in your favor.

Parameter	Type	Required	Comments
trailingStopParams	List<String>	Yes	Trailing stop parameters list
>activationPrice	String	Yes	Activation price Trailing starts when the market reaches this price
>activationType	String	Yes	Activation price type market: Market Price mark: Mark Price index: Index Price For futures only; spot supports market only
>trailType	String	Yes	Trailing mode ratio: Percentage spread: Spread
>trailVariance	String	Yes	Trailing variance When trailType=ratio: spot range [0.1, 20], futures range [0.1, 10]
>preOrderType	String	Yes	Preset order type limit: Limit Order market: Market Order
>preOrderPrice	String	No	Preset order price Required when preOrderType=limit

Iceberg Order (type=iceberg)

Iceberg order splits a large order into a series of smaller sub-orders and drips them into the order book over time, reducing market impact and concealing the full order size.

Parameter	Type	Required	Comments
icebergParams	List<String>	Yes	Iceberg parameters list
>splitMode	String	Yes	Split mode quantity: By quantity per sub-order order: By number of sub-orders
>qtyPerOrder	String	No	Quantity per sub-order Required when splitMode=quantity
>splitOrderNumbers	String	No	Number of sub-orders Required when splitMode=order Range: [1, 100]
>orderPreference	String	Yes	Order preference faster_execution: Faster execution fixed_distance: Fixed distance fixed_price: Fixed price
>executionStrategy	String	No	Sub-order execution strategy queue1: Same-direction price 1 counterparty1: Counterparty price 1 Valid when orderPreference=faster_execution; default queue1
>fixedDistanceType	String	No	Fixed distance type spread: By spread percentage: By percentage Distance from best bid/ask Valid when orderPreference=fixed_distance; default spread
>distance	String	No	Distance value Spread value when fixedDistanceType=spread; percentage when fixedDistanceType=percentage
>fixedPrice	String	No	Fixed price for sub-orders Required when orderPreference=fixed_price
>priceLimit	String	No	Price protection limit Sub-orders will not be placed if price exceeds this limit Valid when orderPreference=faster_execution or orderPreference=fixed_distance

TWAP (type=twap)

TWAP (Time-Weighted Average Price) splits an order into equal-interval sub-orders spread evenly across a configured duration, executing gradually to approximate the time-weighted average price instead of filling all at once.

Parameter	Type	Required	Comments
twapParams	List<String>	Yes	TWAP parameters list
>duration	String	Yes	Total duration in minutes Range: [1, 1440] (1 minute to 24 hours)
>interval	String	Yes	Frequency in seconds Enum: 5, 10, 20, 30, 60
>orderType	String	No	Sub-order type market: Market Order limit: Limit Order Default: market
>limitOffsetType	Number	No	Limit offset type percentage: Percentage spread: Spread Valid when orderType=limit; default percentage
>limitOffsetPercentage	Number	No	Limit offset percentage Decimal format, range [0.001, 0.1]; 0.1 means 10% Required when limitOffsetType=percentage
>limitOffsetSpread	Number	No	Limit offset spread Required when limitOffsetType=spread Spread from latest trade price cannot exceed 20%
>twapTriggerPrice	Number	No	Strategy trigger price
>twapTerminationPrice	Number	No	Strategy termination price Strategy terminates early when market reaches this price

Response

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1695806875837,
  "data": {
    "clientOid": "121211212122",
    "orderId": "121211212122"
  }
}

Response Parameters

Parameter	Type	Comments
orderId	String	Order ID
clientOid	String	Client order ID