Cancel orders

DELETE 
/institutional/subaccounts/orders

Cancels multiple orders for the specified subaccount or market. If the subaccount is not specified, orders for the main account are canceled.

info

This is a private endpoint. To send requests, you need to authenticate.

warning

To use this private endpoint, you must use the API key of your main account with the Include all subaccounts.

Rate limit weight points: N/A

Request

application/json

Schema

Body

subaccountIdstring<uuid>
The unique identifier for the subaccount. If not specified, orders under the main account are cancelled.
marketstring
When specified, orders are canceled only for a specific market.
Example: BTC-EUR
operatorIdintegerrequired
Your identifier for the trader or the bot within your account that made the request.
Example: 1

Example (body)

{
  "subaccountId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "market": "BTC-EUR",
  "operatorId": 1
}

Responses

200

The request was successful.

Response Headers

bitvavo-ratelimit-remaining

The number of remaining weight points before it resets at bitvavo-ratelimit-resetat.

bitvavo-ratelimit-resetat

The time when bitvavo-ratelimit-remaining resets to bitvavo-ratelimit-limit.

bitvavo-ratelimit-limit

The number of available weight points in one minute.

application/json

Schema

Schema

orders object[]
Array of objects with cancelled orders.
Array [
orderIdstring<uuid>
Bitvavo identifier of the cancelled order.
Example: 1be6d0df-d5dc-4b53-a250-3376f3b393e6
clientOrderIdstring<uuid>
Your identifier of the cancelled order. Only returned if specified in the request.
Example: 2be7d0df-d8dc-7b93-a550-8876f3b393e9.
operatorIdinteger
Identifier for the trader or bot that made request.
Example: 1
]

Example (body)

{
  "orders": [
    {
      "orderId": "1be6d0df-d5dc-4b53-a250-3376f3b393e6",
      "clientOrderId": "2be7d0df-d8dc-7b93-a550-8876f3b393e9.",
      "operatorId": 1
    }
  ]
}

4XX

For error codes, see Handle errors.