撤銷委託單
警告
- 您必須指定
orderId或者orderLinkId. - 若
orderId和orderLinkId之間不匹配, 系統將會優先處理orderId. - 您只能撤銷未成交和部分成交的訂單.
HTTP 請求
POST /unified/v3/private/order/cancel
請求參數
| 參數 | 是否必需 | 類型 | 說明 |
|---|---|---|---|
| category | true | string | 產品類型. linear, option |
| symbol | true | string | 合約名稱 |
| orderId | false | string | 訂單Id. orderId和orderLinkId必傳其中一個 |
| orderLinkId | false | string | 用戶自定義訂單Id. orderId和orderLinkId必傳其中一個 |
| orderFilter | false | string | Order: 普通單, StopOrder: 條件單 |
響應參數
| 參數 | 類型 | 說明 |
|---|---|---|
| orderId | string | 訂單Id |
| orderLinkId | string | 用戶自定義訂單Id |
请求示例
curl --location --request POST 'https://api-testnet.bybit.com/unified/v3/private/order/cancel' \
--header 'X-BAPI-SIGN-TYPE: 2' \
--header 'X-BAPI-SIGN: XXXXX' \
--header 'X-BAPI-API-KEY: {api key}' \
--header 'X-BAPI-TIMESTAMP: 1657871228347' \
--header 'X-BAPI-RECV-WINDOW: 5000' \
--header 'Content-Type: application/json' \
--data-raw '{
"category": "linear",
"orderId": "4c51a45f-7795-4b38-9b66-3c306b73f112",
"symbol": "BTCUSDT"
}'
響應示例
{
"retCode": 0,
"retMsg": "OK",
"result": {
"orderId": "4c51a45f-7795-4b38-9b66-3c306b73f112",
"orderLinkId": "e80d558e-ed"
}
}