跳至主要内容

撤銷所有訂單

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

現貨: 經典帳戶 - 最多取消500單; 統一帳戶 - 無限制
期貨: 經典帳戶 - 最多取消500單; 統一帳戶 - 最多取消500單
期權: 統一帳戶 - 無限制

HTTP請求

POST /v5/order/cancel-all

請求參數

參數是否必需類型說明
categorytruestring產品類型
symbolfalsestring合約名稱
對於linear & inverse: 若不傳baseCoinsettleCoin, 該字段必傳
baseCoinfalsestring交易幣種
  • 經典帳戶linear & inverse:
    當通過baseCoin來全部撤單時, 會將linear和inverse訂單全部撤掉。若不傳symbolbaseCoin, 則該字段必傳
  • 統一帳戶2.0, 統一帳戶1.0linear & 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": 失敗
  • 統一帳戶1.0(inverse), 經典帳戶(linear, inverse)不返回該字段
  • 信息

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

    請求示例

    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
    }