撤銷委託單

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

重要

• 您必須指定orderId或者orderLinkId.
• 若orderId和orderLinkId之間不匹配, 系統將會優先處理orderId.
• 您只能撤銷未成交和部分成交的訂單.

HTTP請求

POST /cloud/trade/v3/order/cancel

請求參數

參數	是否必需	類型	說明
category	true	string	產品類型 普通帳戶: spot, linear, inverse
symbol	true	string	合約名稱
orderId	false	string	訂單Id. orderId和orderLinkId必傳其中一個
orderLinkId	false	string	用戶自定義訂單Id. orderId和orderLinkId必傳其中一個
orderFilter	false	string	僅spot有效. Order: 普通單,tpslOrder: 止盈止損單. 若不傳, 默認是Order

響應參數

參數	類型	說明
orderId	string	訂單Id
orderLinkId	string	用戶自定義訂單Id

---

請求示例

POST /cloud/trade/v3/order/cancel HTTP/1.1
Host: openapi-testnet.zoomex.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1672217376681
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json

{
  "category": "linear",
  "symbol": "BTCUSDT",
  "orderLinkId": null,
  "orderId":"c6f055d9-7f21-4079-913d-e6523a9cfffa"
}

響應示例

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "orderId": "c6f055d9-7f21-4079-913d-e6523a9cfffa",
        "orderLinkId": "linear-004"
    },
    "retExtInfo": {},
    "time": 1672217377164
}