Skip to main content

REST API Trading - Cancel Stop order

Cancel Stop order

Written by Albert
Updated today

Cancel Stop order

DELETE /frontoffice/api/v3/stop-orders/{orderId}

Summary

Use this method to cancel an active Stop order placed on SPOT, CFD, or Perpetual markets.

Request

Header parameters

accountId required

The trading account identifier.

Path parameters

orderId required

The Stop order identifier to cancel.

Request example

DELETE /frontoffice/api/v3/stop-orders/01K2MNGAWPMQJ7WGATFSCAS1G4 HTTP/1.1
Host: {host}
Authorization: Bearer JWT
accountId: {accountId}
Content-Type: application/json; x-api-version=4.0
Accept: */*

Response

In case of success, an object will be returned.

Each object contains the following information:

order object

The canceled order.

order.marketId string

The market identifier, same as in the request.

order.marketDisplayName string

The market ticker.

order.orderId string

The unique identifier of the order assigned by the system.

order.orderType string

The order type, same as in the request.

order.side string

The order side, same as in the request.

order.requestedPrice decimal string | nullable

The limit price for Limit orders (the maximum price for a buy or minimum price for a sell).

Must be null or omitted for Market orders.

order.activationPrice decimal string | nullable

The trigger price that activates the Stop order.

order.requestedAmount decimal string

The quantity of the base asset to buy or sell, same as in the request.

order.timeInForce string

The time-in-force policy, same as in the request.

order.status string

The current order status.

Possible values:

  • WaitingForActivation

  • Activated

  • Rejected

order.createdAt string

The timestamp when the order was created, in the following format: YYYY-MM-DDTHH:MM:SS.sssZ.

order.updatedAt string

The timestamp of the most recent update to the order, in the following format: YYYY-MM-DDTHH:MM:SS.sssZ.

order.cancellationDate string | nullable

The timestamp when the order was cancelled or expired, in the following format: YYYY-MM-DDTHH:MM:SS.sssZ; null if not cancelled.

Response example β€” 200: OK

{
"order": {
"marketId": "perp.btc_usdt",
"marketDisplayName": "Perpetual BTC/USDT",
"orderId": "01K2MNGAWPMQJ7WGATFSCAS1G4",
"orderType": "Limit",
"side": "Sell",
"requestedPrice": "115100",
"activationPrice": "115000",
"requestedAmount": "1",
"timeInForce": "Gtc",
"status": "Rejected",
"createdAt": "2025-08-14T16:09:44.5986099Z",
"updatedAt": "2025-08-14T16:09:44.5986103Z",
"cancellationDate": null
}
}

Did this answer your question?