批量撤銷委託單

提示

該接口可以批量撤銷多筆訂單

• 您必須指定orderId或者orderLinkId.
• 若orderId和orderLinkId之間不匹配, 系統將會優先處理orderId
• 您只能撤銷未成交和部分成交的訂單.
• 期貨和期權的訂單撤銷無法同時在一次請求裏同時撤單。如果期貨和期權的訂單都在一個請求裏，則根據category的類型，僅會操作與category相匹配的訂單。

HTTP請求

POST /unified/v3/private/order/cancel-batch

請求參數

參數	是否必需	類型	說明
category	true	string	產品類型. linear,option
request	true	array	Object
> symbol	true	string	合約名稱
> orderId	false	string	訂單Id. orderId和orderLinkId必傳其中一個
> orderLinkId	false	string	用戶自定義訂單Id. orderId和orderLinkId必傳其中一個

響應參數

參數	類型	說明
result	Object
> list	array	Object
>> category	string	產品類型
>> symbol	string	合約名稱
>> orderId	string	訂單Id
>> orderLinkId	string	用戶自定義訂單Id
retExtInfo	Object
> list	array	Object
>> code	integer	成功/錯誤碼
>> msg	string	成功/錯誤信息

請求示例

POST /unified/v3/private/order/cancel-batch HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN-TYPE: 2
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1672818987475
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json

{
    "category": "linear",
    "request": [
        {
            "symbol": "ETHUSDT",
            "orderLinkId": "test-002"
        },
        {
            "symbol": "XRPUSDT",
            "orderLinkId": "test-003"
        }
    ]
}

響應示例

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "list": [
            {
                "category": "linear",
                "symbol": "ETHUSDT",
                "orderId": "",
                "orderLinkId": "test-002"
            },
            {
                "category": "linear",
                "symbol": "XRPUSDT",
                "orderId": "",
                "orderLinkId": "test-003"
            }
        ]
    },
    "retExtInfo": {
        "list": [
            {
                "code": 0,
                "msg": "success"
            },
            {
                "code": 110001,
                "msg": "order not exists or too late to cancel"
            }
        ]
    },
    "time": 1672818989928
}