Skip to main content

Batch Order

  • Rate limit: 5 requests/second/UID
  • Rate limit: 1 request/second/UID for copy trading traders

Description

  • Supports TP/SL feature. If the current underlying asset does not exist in the position, it is intended to preset the TP/SL. If the current underlying exists in the position, it is intended to modify the TP/SL
  • Ignore the tradeSide parameter when position mode is in one-way-mode

HTTP Request

  • POST /api/v2/mix/order/batch-place-order
Request Example
curl -X POST "https://api.bitget.com/api/v2/mix/order/batch-place-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 '{
"symbol": "BTCUSDT",
"productType": "usdt-futures",
"marginMode": "crossed",
"marginCoin": "USDT",
"orderList": [{
"size": "1",
"side": "buy",
"tradeSide": "open",
"orderType": "market",
"force": "gtc",
"clientOid": "123456",
"reduceOnly": "NO",
"presetStopSurplusPrice": "20000",
"presetStopLossPrice": "10000"
}
]
}'

Request Parameters

ParameterTypeRequiredDescription
symbolStringYesTrading pair
productTypeStringYesProduct type
USDT-FUTURES USDT professional futures
COIN-FUTURES Mixed futures
USDC-FUTURES USDC professional futures
SUSDT-FUTURES USDT professional futures demo
SCOIN-FUTURES Mixed futures demo
SUSDC-FUTURES USDC professional futures demo
marginCoinStringYesMargin coin, must be capitalized
marginModeStringYesPosition mode
isolated: isolated margin
crossed: crossed margin
orderListList<String>YesOrder list, maximum length: 50
>sizeStringYesAmount
>priceStringNoPrice of the order.
Required if the order type is limit
>sideStringYesOrder direction
buy: Buy
sell: Sell
>tradeSideStringNoDirection
Only required in hedge-mode
Open and Close Notes:
For open long, side fill in"buy"; tradeSide should be "Open"
For open short, side fill in "sell"; tradeSide should be "open"
For close long, side fill in "buy"; tradeSide should be "close"
For close short, side fill in "sell";tradeSide should be "close"
>orderTypeStringYesOrder type
limit: limit orders
market: market orders
>forceStringNoOrder expiration date.
Required if the orderType is limit, default value is gtc
ioc: Immediate or cancel
fok: Fill or kill
gtc: Good till canceled
post_only: Post only
>clientOidStringNoCustom order ID, must be unique. The idempotency time is 20 minutes
>reduceOnlyStringNoWhether or not to just reduce the position: YES, NO
Default: NO
Applicable only in one-way-position mode
>presetStopSurplusPriceStringNoTake-profit value
No take-profit is set if the field is empty.
>presetStopLossPriceStringNoStop-loss value
No stop-loss is set if the field is empty.
>stpModeStringNoSTP Mode, default none
none not setting STP
cancel_taker cancel taker order
cancel_maker cancel maker order
cancel_both cancel both of taker and maker orders
Response Example
{
"code": "00000",
"data": {
"successList": [
{
"orderId": "121211212122",
"clientOid": "BITGET#121211212122"
}
],
"failureList": []
},
"msg": "success",
"requestTime": 1627293504612
}

Response Parameters

ParameterTypeDescription
successListList<Object>Successful order list
>orderIdStringOrder ID
>clientOidStringCustomize order ID
failureListList<Object>Failed order list
>orderIdStringOrder ID
>clientOidStringCustomize order ID
>errorMsgStringFailure reason
>errorCodeStringFailure code

How was your Reading Experience with us?