跳至主要内容

撤銷所有訂單

撤銷全部委託單

普通帳戶覆蓋範圍: Spot/USDT永續 / 反向合約

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

HTTP請求

POST /cloud/trade/v3/order/cancel-all

請求參數

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

  • 響應參數

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

    請求示例

    POST /cloud/trade/v3/order/cancel-all HTTP/1.1
    Host: openapi-testnet.zoomex.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": "f6a73e1f-39b5-4dee-af21-1460b2e3b27c",
    "orderLinkId": "a001"
    }
    ]
    },
    "retExtInfo": {},
    "time": 1672219780463
    }