跳至主要内容

撤銷所有訂單

撤銷全部委託單

統一帳戶覆蓋範圍: 現貨 / USDT永續 / USDC永續 / USDC交割 / 反向合約 / 期權
經典帳戶覆蓋範圍: USDT永續 / 反向合約

信息
  • 支持按照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
  • 經典帳戶: spot, linear, inverse
symbolfalsestring合約名稱. 對於linear & inverse: 若不傳baseCoinsettleCoin, 該字段必傳
baseCoinfalsestring交易幣種
  • 對於經典帳戶下的linear & inverse: 當通過baseCoin來全部撤單時,會將linear和inverse訂單全部撤掉。若不傳symbolbaseCoin, 則該字段必傳
  • 對於統一帳戶下的linear & inverse: 當通過baseCoin來全部撤單時,會將對應category的訂單全部撤掉。若不傳symbolbaseCoin, 則該字段必傳
  • 對於經典帳戶的現貨: 該字段無效
settleCoinfalsestring結算幣種
  • 對於linear & inverse: 該字段必傳, 若不傳symbolbaseCoin
  • 該字段不支持spot
orderFilterfalsestring
  • 當category=spot, 該字段可以傳Order(普通單), tpslOrder(止盈止損單), StopOrder(條件單), OcoOrder, BidirectionalTpslOrder(現貨雙向止盈止損訂單). 若不傳, 則默認是撤掉Order
  • 當category=linear 或者 inverse, 該字段可以傳Order(普通單), StopOrder(條件單, 包括止盈止損單和追蹤出場單). 若不傳, 則所有類型的訂單都會被撤掉
  • 當category=option, 該字段可以傳Order, 不管傳與不傳, 都是撤掉所有訂單
stopOrderTypefalsestring條件單類型, Stop
  • 僅用於當category=linear 或者 inverse以及orderFilter=StopOrder時, 若想僅取消條件單 (不包括止盈止損單和追蹤出場單), 則可以傳入該字段

  • 響應參數

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

    請求示例

    POST /v5/order/cancel-all HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    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
    }