Skip to main content

Cancel Order

note

You could cancel those unfilled or partially filled orders.

HTTP Request

POST /contract/v3/private/order/cancel

Request Parameters

ParameterRequiredTypeComments
symboltruestringSymbol name
orderIdfalsestringOrder id. Either orderId or orderLinkId is required
orderLinkIdfalsestringUser customised order id. Either orderId or orderLinkId is required

Response Parameters

ParameterTypeComments
orderIdstringOrder ID
orderLinkIdstringUser customised order id

Request Example

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"
}

Response Example

{
"retCode": 0,
"retMsg": "OK",
"result": {
"orderId": "a0c76874-1777-48dd-9f99-b4120ec71cc0",
"orderLinkId": "xrp_12"
},
"retExtInfo": {},
"time": 1670570872075
}