Cancel 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

Cancel a single open order identified by orderId or clOrderId on the given trading pair.

Request Parameters

Name	Type	Required	Description
symbol	String	Yes	Trading pair
orderId	String	No	Order ID to cancel; at least one of orderId or clOrderId is required
clOrderId	String	No	Client-supplied order ID to cancel; at least one of orderId or clOrderId is required

Response Content

Name	Type	Description
orderId	String	Server-assigned order identifier
clOrderId	String	Echo of the client-supplied order identifier if one was provided
status	Integer	Numeric status code reflecting the current state of the order (e.g. filled, cancelled, rejected)
market	String	Trading pair, e.g. BTC-USDT
type	Integer	Numeric code identifying the order type (e.g. LIMIT, MARKET, TWAP, PEG)
orderSide	String	BUY or SELL
orderPrice	Double	Order price
postOnly	Boolean	Whether the order was submitted as post-only
timestamp	Long	Server-side event timestamp in epoch milliseconds
orderDetailType	String	Detailed order sub-type when applicable (e.g. TWAP for algo TWAP orders)
message	String	Optional diagnostic message; present only when one is returned (e.g. rejection reason)
userQuoteCurrency	String	Quote currency configured for the user
orderCurrency	String	'quote' or 'base'; indicates whether the quote-size or base-size fields below are populated
originalOrderBaseSize	Double	Original size in base currency; populated when orderCurrency is 'base'
originalOrderQuoteSize	Double	Original size in quote currency; populated when orderCurrency is 'quote'
currentOrderBaseSize	Double	Currently active size in base currency; populated when orderCurrency is 'base'
currentOrderQuoteSize	Double	Currently active size in quote currency; populated when orderCurrency is 'quote'
remainingOrderBaseSize	Double	Remaining unfilled size in base currency; populated when orderCurrency is 'base'
remainingOrderQuoteSize	Double	Remaining unfilled size in quote currency; populated when orderCurrency is 'quote'
filledBaseSize	Double	Size filled by the most recent match, in base currency
totalFilledBaseSize	Double	Cumulative filled size across all matches, in base currency
avgFilledPrice	Double	Volume-weighted average fill price
time_in_force	String	Time-in-force policy (GTC, IOC, FOK); null when not applicable to the order type

example

DELETEhttps://api.btse.com/spot/api/v4/trade/orders

Response (default)

[
  {
    "orderId": "4eca2eb4-e6ad-4355-ae12-5ce757b105b3",
    "clOrderId": "",
    "status": 6,
    "market": "BTC-USD",
    "type": 76,
    "orderSide": "BUY",
    "orderPrice": 0,
    "postOnly": false,
    "timestamp": 1784891308981,
    "orderDetailType": null,
    "message": null,
    "userQuoteCurrency": "USD",
    "orderCurrency": "base",
    "originalOrderBaseSize": 0.00001,
    "originalOrderQuoteSize": null,
    "currentOrderBaseSize": 0.00001,
    "currentOrderQuoteSize": null,
    "remainingOrderBaseSize": 0.00001,
    "remainingOrderQuoteSize": null,
    "filledBaseSize": 0,
    "totalFilledBaseSize": 0,
    "avgFilledPrice": 0,
    "time_in_force": "GTC"
  }
]