Skip to main content

Cancel order

DELETE 
/institutional/subaccounts/order

Cancels a single open order for the specified subaccount. If the subaccount is not specified, cancels the order for the main account.

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​

Body

    subaccountIdstring<uuid>

    The unique identifier for the subaccount. If not specified, orders under the main account are cancelled.

    marketstringrequired

    The market in which order was made.

    Example: BTC-EUR
    orderIdstring<uuid>required

    Bitvavo identifier of the order. If both clientOrderId and orderId are set, clientOrderId is used to identify the order.

    Example: 1be6d0df-d5dc-4b53-a250-3376f3b393e6
    clientOrderIdstring<uuid>

    Your identifier of the order. If both clientOrderId and orderId are set, clientOrderId is used to identify the order.

    Example: 2be7d0df-d8dc-7b93-a550-8876f3b393e9.
    operatorIdintegerrequired

    Your identifier for the trader or the bot within your account that made the request.

    Example: 1

Responses​

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.

Schema
    orderIdstring<uuid>

    Bitvavo identifier of the 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

    Your identifier for the trader or the bot within your account that made the request.

    Example: 1