撤銷委託單
備註
- 您必須指定
orderId或者orderLinkId. - 若
orderId和orderLinkId之間不匹配, 系統將會優先處理orderId. - 您只能撤銷未成交和部分成交的訂單.
HTTP 請求
POST /contract/v3/private/order/cancel
請求參數
| 參數 | 是否必需 | 類型 | 說明 |
|---|---|---|---|
| symbol | true | string | 合約名稱 |
| orderId | false | string | 訂單Id. orderId和orderLinkId必傳其中一個 |
| orderLinkId | false | string | 用戶自定義訂單Id. orderId和orderLinkId必傳其中一個 |
響應參數
| 參數 | 類型 | 說明 |
|---|---|---|
| orderId | string | 訂單ID |
| orderLinkId | string | 用戶自定義訂單ID |
请求示例
POST /contract/v3/private/order/cancel HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1670570871662
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json
{
"symbol": "BTCUSDT",
"orderLinkId": null,
"orderId": "a0c76874-1777-48dd-9f99-b4120ec71cc0"
}
響應示例
{
"retCode": 0,
"retMsg": "OK",
"result": {
"orderId": "a0c76874-1777-48dd-9f99-b4120ec71cc0",
"orderLinkId": "xrp_12"
},
"retExtInfo": {},
"time": 1670570872075
}