Skip to main content

Cancel Order

HTTP Request

POST /spot/v3/private/cancel-order

Request Parameters

ParameterRequiredTypeComments
orderIdfalsestringOrder ID. Required if not passing orderLinkId
orderLinkIdfalsestringUnique user-set order ID. Required if not passing orderId
orderCategoryfalseintegerOrder category. 0:normal order by default; 1TP/SL order, Required for TP/SL order.

Response Parameters

ParameterTypeComments
orderIdstringOrder ID
orderLinkIdstringUser-generated order ID
symbolstringName of the trading pair
statusstringOrder status
accountIdstringAccount ID
orderPricestringOrder price
createTimestringOrder Creation Time
orderQtystringOrder quantity
execQtystringExecuted quantity
timeInForcestringTime in force
orderTypestringOrder type
sidestringSide. BUY, SELL

Request Example

curl --location --request POST 'https://api-testnet.bybit.com/spot/v3/private/cancel-order' \
--header 'X-BAPI-SIGN: XXXXX' \
--header 'X-BAPI-API-KEY: {api key}' \
--header 'X-BAPI-TIMESTAMP: 1659078017415' \
--header 'X-BAPI-RECV-WINDOW: 5000' \
--header 'Content-Type: application/json' \
--data-raw '{
"orderId": "1210810256551063296",
"orderLinkId": null
}'

Response Example

{
"retCode": 0,
"retMsg": "OK",
"result": {
"orderId": "1210810256551063296",
"orderLinkId": "spotA0010",
"symbol": "BTCUSDT",
"status": "NEW",
"accountId": "533287",
"createTime": "1659075830464",
"orderPrice": "23500",
"orderQty": "0.01",
"execQty": "0",
"timeInForce": "GTC",
"orderType": "LIMIT",
"side": "SELL"
},
"retExtMap": {},
"retExtInfo": {},
"time": 1659078151226
}