撤銷委託單
警告
- 您必須指定
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"
}
}