跳至主要内容

撤銷所有訂單

信息
  • 支持按照symbol/baseCoin/settleCoin撤銷訂單,若您傳入了多個參數組合, 系統僅會處理其中一個參數,其中優先級為symbol > baseCoin > settleCoin.
  • 注意: 當category=option, 您可以不傳人三個參數中的任何一個,就能取消所有期權的委託單。但是, 對於linearinverse, 您必需指定三個參數的其中一個。
  • 注意: 當category=spot, 您可以不傳人任何參數,就能取消所有現貨的委託單 (默認普通單)。
信息

現貨: 無限制
期貨: 最多取消500單 (當您訂單數量超過500單時, 系統會隨機挑選500單進行取消)
期權: 統無限制

HTTP請求

POST /v5/order/cancel-all

請求參數

參數是否必需類型說明
categorytruestring產品類型 spot, linear, inverse, option
symbolfalsestring合約名稱
對於linear & inverse: 若不傳baseCoinsettleCoin, 該字段必傳
baseCoinfalsestring交易幣種
  • linear & inverse: 當通過baseCoin來全部撤單時, 會將對應category的訂單全部撤掉。若不傳symbolbaseCoin, 則該字段必傳
settleCoinfalsestring結算幣種
  • 對於linear & inverse: 該字段必傳, 若不傳symbolbaseCoin
  • option: USDC或者USDT
  • 該字段不支持spot
orderFilterfalsestring
  • category=spot, 該字段可以傳:
    Order(普通單), tpslOrder(止盈止損單)
    StopOrder(條件單), OcoOrder
    BidirectionalTpslOrder(現貨雙向止盈止損訂單)
    若不傳, 則默認是撤掉Order
  • 當category=linear 或者 inverse, 該字段可以傳Order(普通單), StopOrder(條件單, 包括止盈止損單和追蹤出場單), OpenOrder(僅取消開倉單). 若不傳, 則所有類型的訂單都會被撤掉
  • 當category=option, 該字段可以傳Order,StopOrder, 若不傳, 則撤掉這兩種類型下所有訂單
stopOrderTypefalsestring條件單類型, Stop
  • 僅用於當category=linear 或者 inverse以及orderFilter=StopOrder時, 若想僅取消條件單 (不包括止盈止損單和追蹤出場單), 則可以傳入該字段

響應參數

參數類型說明
listarrayObject
> orderIdstring訂單ID
> orderLinkIdstring用戶自定義的訂單ID
successstring"1": 成功, "0": 失敗
信息

ack僅表示請求被成功接受. 請使用websocket-order推送來確認訂單狀態

請求示例

POST /v5/order/cancel-all HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1672219779140
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json

{
"category": "linear",
"symbol": null,
"settleCoin": "USDT"
}

響應示例

{
"retCode": 0,
"retMsg": "OK",
"result": {
"list": [
{
"orderId": "1616024329462743808",
"orderLinkId": "1616024329462743809"
},
{
"orderId": "1616024287544869632",
"orderLinkId": "1616024287544869633"
}
],
"success": "1"
},
"retExtInfo": {},
"time": 1707381118116
}