Skip to main content

Batch Place Stop Orders

Info
  • This endpoint requires signature. For specific signature rules, please refer to Authentication
  • This endpoint will trigger rate limit. For specific rules, please refer to Rate Limit.
Dangerous
  • When the server pressure level is too high, placing an order will trigger a 3008 error.
  • When a 3008 error is triggered, the order cancellation request still has high priority, that is, the server will give priority to the order cancellation request.

HTTP request

POST /futures/batch-stop-order

Request parameters

Parameter NameRequiredTypeNotes
markettruestringMarket name
market_typetruestringMarket type.
Note: In spot related functions, only SPOT or MARGIN can be used
In futures related functions, only FUTURES can be used
sidetruestringOrder side
typetruestringOrder type
amounttruestringOrder amount
pricefalsestringOrder price
trigger_price_typetruestringTrigger price type, latest_price or mark_price or index_price
trigger_pricetruestringStop order trigger price
client_idfalsestringUser-defined ID
is_hidefalseboolWhether to hide the orders, default as: false
stp_modefalsestringSelf-trading protection mode.
ct: Cancel remaining Taker orders immediately
cm: Cancel remaining Maker orders immediately (remaining taker orders are not affected if set as limit price orders, remaining untaken taker orders continue to stand with limit price)
both: Cancel remaining Taker and Maker orders immediately
Note: During the auction period, stop order stp_mode is not effective

Return parameter

Parameter NameTypeNotes
stop_idintStop order ID

Request example

{
"orders": [
{
"market": "CETUSDT",
"market_type": "FUTURES",
"side": "buy",
"type": "limit",
"amount": "10000",
"price": "1",
"trigger_price_type": "mark_price",
"trigger_price": "1.1",
"client_id": "user1",
"is_hide": true
}
]
}

Response example

{
"code": 0,
"data": [
{
"code": 0,
"data": {
"stop_id": 287330817
},
"message": "OK"
}
]
"message": "OK"
}