Cancel an order

DELETE🔒 Trading

⚡ Orders: 75 req/s per endpoint · 75 req/s per user

tip

Try It Out — test this endpoint in the API Explorer

Cancels a single order identified by orderId or clOrderId for the given symbol.

Request Parameters

Name	Type	Required	Description
symbol	String	Yes	Trading pair symbol of the order to cancel.
orderId	String	No	Server-assigned order id to cancel. Required if clOrderId is not provided.
clOrderId	String	No	Client-assigned order id to cancel. Required if orderId is not provided.

Response Content

Name	Type	Description
orderId	String	Server-assigned order id of the cancelled order.
clOrderId	String	Client-assigned order id echoed from the request.
symbol	String	Trading pair symbol of the cancelled order.
orderSide	String	Order side: BUY or SELL.
type	Integer	Order type code.
orderPrice	Double	Limit price of the cancelled order.
orderSize	Double	Order size in number of contracts at the time of cancellation.
filledSize	Double	Cumulative filled size before the cancel took effect.
status	Integer	Order status code after the cancel.
timestamp	Long	Server timestamp of the cancellation, in milliseconds since epoch.

example

DELETEhttps://api.btse.com/futures/api/v3/trade/orders

Request (default)

{
  "symbol": "BTC-PERP",
  "orderId": "0251ea47-88b5-48c0-aeb3-b38774fd1f90"
}

Response (default)

[
  {
    "orderId": "0251ea47-88b5-48c0-aeb3-b38774fd1f90",
    "clOrderId": "",
    "symbol": "BTC-PERP",
    "orderSide": "BUY",
    "type": 76,
    "orderPrice": 0,
    "orderSize": 1,
    "filledSize": 0,
    "status": 6,
    "timestamp": 1784882345126
  }
]