Track your orders

REQUEST wss://ws.bitvavo.com/v2 account

Subscribes to events that return data when your orders in the specified market are updated.

You can receive one of the following events:

• Subscribe: receive a confirmation that you subscribed to the channel.
• Order: receive data about all orders you created or updated.
• Fill: receive data about all fills or trades executed for an orders you created.

info

Authentication required. To send messages, you need to authenticate connection.

Request

Schema

Body

actionstringrequired
Set to subscribe to start or to unsubscribe to stop the subscription.
Possible values: [subscribe, unsubscribe]
channels object[]required
The events you want to subscribe to.
Array [
namestring
The channel to which you want to subscribe.
Example: account
marketsstring[]
The markets for which you want stream the data.


You can subscribe to all currently listed markets. Instead of an array of markets, use * as the value: "markets": "*".
Example: ["BTC-EUR"]
]

Example (body)

{
  "action": "subscribe",
  "channels": [
    {
      "name": "account",
      "markets": [
        "BTC-EUR"
      ]
    }
  ]
}

Response

Account confirmation

Schema

Schema

eventstring
The returned event.
Example: subscribed
subscriptions object
Object containing all current active subscriptions.
channel-namestring[]
The markets you subscribed to for the account.
Example: ["BTC-EUR","ETH-BTC","ETH-EUR"]

Example (body)

{
  "event": "subscribed",
  "subscriptions": {
    "channel-name": [
      "BTC-EUR",
      "ETH-BTC",
      "ETH-EUR"
    ]
  }
}

Order event

Schema

Schema

eventstring
The returned event.
Example: order
orderIdstring<UUID>
Bitvavo identifier of the order. An orderId is unique per market. Different markets can use the same orderId values.
Example: 80b5f04d-21fc-4ebe-9c5f-6d34f78ee477
clientOrderIdstring<UUID>
Your identifier of the order. Only returned if specified in the request.
Example: 2be7d0df-d8dc-7b93-a550-8876f3b393e9
operatorIdinteger<int64>required
Teh identifier for the trader or the bot that made the request.
Example: 543462
marketstring
The market in which the order was placed.
Example: BTC-EUR
createdinteger
The Unix timestamp in milliseconds when the order was created.
Example: 1548684420771
updatedinteger
The Unix timestamp in milliseconds when the order was last updated.
Example: 1548684420771
statusstring
The current status of the order.
Possible values: [new, awaitingTrigger, canceled, expired, filled, partiallyFilled]
sidestring
Indicates whether the order is to buy or sell the asset.
Possible values: [buy, sell]
orderTypestring
The type of order you created.
Possible values: [limit, market]
amountstring
The quantity of the base currency to buy or sell.
Example: 1
amountRemainingstring
The quantity of the base currency remaining after the sum of fills is subtracted from the amount.
Example: 0.567
pricestring
The price of the order.
Example: 9225.1
onHoldstring
The amount of 'onHoldCurrency' that is reserved for this order. This is released when orders are canceled.
Example: 9225.1
onHoldCurrencystring
The currency that is onHold while the order is processed. This is the quote currency for buy orders and base currency for sell orders.
Example: EUR
triggerPricestring
The price calculated using triggerAmount and triggerType for the stopLoss, stopLossLimit, takeProfit, or takeProfitLimit types of orders.
Example: 4000
triggerAmountstring
The trigger price in quote currency for which you want to buy or sell 1 unit of the base currency. This value and triggerType are used to calculate triggerPrice.
Example: 4000
triggerTypestring
The type of trigger you set to fill the order when the condition is met. This value and triggerAmount are used to calculate triggerPrice.
Possible values: [price]
triggerReferencestring
The reference price which triggered the order to be filled for stopLoss, stopLossLimit, takeProfit, or takeProfitLimit types of orders.
Possible values: [lastTrade, bestBid, bestAsk, midPrice]
timeInForcestring
Only for limit orders. How long an orderType stays active for.
Possible values:
• FOK: Fill-Or-Kill. Fills the entire order from existing orders, or cancels the entire order.
• GTC: Good-Til-Canceled. Stays in the order book until the entire order is filled or you manually cancel it.
• IOC: Immediate-Or-Cancel. Fills existing orders and cancels the unfilled balance.
Possible values: [GTC, IOC, FOK]
postOnlyboolean
If true, cancels limit orders that match immediately. This ensures you pay the maker fee and not the taker fee.
Default value: false
selfTradePreventionstring
Self-trading is not allowed on Bitvavo.
Indicates how to prevent self-trading for conflicting orders of any type.
Possible values:
• decrementAndCancel: (default) decreases the amount in the conflicting order by the difference between the buy and sell orders in the same market. Cancels the lower order. For example, if a sell order is for 500 BTC and a buy order is for 300 BTC, it cancels the buy order and adjusts the sell order to 200 BTC.
• cancelOldest: cancels the older conflicting order in the same market.
• cancelNewest: cancels the later conflicting order in the same market.
• cancelBoth: cancels both conflicting orders in the same market.
Possible values: [decrementAndCancel, cancelOldest, cancelNewest, cancelBoth]
Default value: decrementAndCancel
visibleboolean
Whether this order is visible in the order book.
filledAmountstring
The total amount of the base currency that has been filled.
Example: 1.234
filledAmountQuotestring
The total amount of the quote currency that has been filled.
Example: 5000
executionTypestring
The type of update executed for the order.
Possible values: [new, trade, canceled, expired, updated, triggered, restated]
restatementReasonstring
Specifies the reason why the status of the order was changed. For example, when an order is canceled by the Price protection checks.
Possible values: [decrementOnSelfTradePrevention, cancelOnSelfTradePrevention, cancelOnPlacementPriceProtection, cancelOnExecutionPriceProtection, cancelOnSpreadProtection, cancelOnReferencePriceProtection, cancelPostOnlyOnAuctionMatching, cancelOnMaintenance, cancelOnDisconnect, cancelOnDelisting, cancelOnLockPlaced, cancelOnAdminRequest, cancelPostOnly]
createdNsinteger
The Unix timestamp in nanoseconds when the order was created.
Example: 1752139200000000000
updatedNsinteger
The Unix timestamp in nanoseconds when the order was last updated.
Example: 1752139200000000000
codGroupIdinteger
Your identifier for a group of orders.
Example: 1

Example (body)

{
  "event": "order",
  "orderId": "80b5f04d-21fc-4ebe-9c5f-6d34f78ee477",
  "clientOrderId": "2be7d0df-d8dc-7b93-a550-8876f3b393e9",
  "operatorId": 543462,
  "market": "BTC-EUR",
  "created": 1548684420771,
  "updated": 1548684420771,
  "status": "new",
  "side": "buy",
  "orderType": "limit",
  "amount": "1",
  "amountRemaining": "0.567",
  "price": "9225.1",
  "onHold": "9225.1",
  "onHoldCurrency": "EUR",
  "triggerPrice": "4000",
  "triggerAmount": "4000",
  "triggerType": "price",
  "triggerReference": "lastTrade",
  "timeInForce": "GTC",
  "postOnly": false,
  "selfTradePrevention": "decrementAndCancel",
  "visible": false,
  "filledAmount": "1.234",
  "filledAmountQuote": "5000",
  "executionType": "new",
  "restatementReason": "decrementOnSelfTradePrevention",
  "createdNs": 1752139200000000000,
  "updatedNs": 1752139200000000000,
  "codGroupId": 1
}

Fill event

Schema

Schema

eventstring
The returned event.
Example: fill
marketstring
The market in which the order was placed.
Example: BTC-EUR
orderIdstring<UUID>
The identifier of the order on which has been filled.
Example: 80b5f04d-21fc-4ebe-9c5f-6d34f78ee477
clientOrderIdstring<UUID>
Your identifier of the order. Only returned if specified in the request.
Example: 2be7d0df-d8dc-7b93-a550-8876f3b393e9
operatorIdinteger<int64>required
The identifier for the trader or the bot that made the request.
Example: 543462
fillIdstring
The identifier of the returned fill.
Example: 15d14b09-389d-4f83-9413-de9d0d8e7715
timestampinteger
The current Unix timestamp in milliseconds.
Example: 1542967486256
amountstring
The amount in base currency for which the trade has been made.
Example: 0.005
sidestring
Indicates if the order was to buy or sell an asset.
Possible values: [sell, buy]
pricestring
The price in quote currency for which the trade has been made.
Example: 5000.1
takerboolean
Indicates if you are the taker or maker in the trade.
• true: you are the taker. Your order filled a resting order.
• false: you are the maker. Your resting order was filled by an incoming order.
Example: true
feestring
The amount you pay Bitvavo in feeCurrency to process orderId. For more information about your fees, call GET /account/fees.
If settled is false, this object is not included in these return parameters. To retrieve the value of settled, see the fills object in the return parameters for calls to GET /order.
fee is negative for rebates.
Example: 0.03
feeCurrencystring
The currency that fee is paid in.
If settled is false, this object is not included in these return parameters. To retrieve the value of settled, see the fills object in the return parameters for calls to GET /order.
Example: EUR
timestampNsinteger
The current Unix timestamp in nanoseconds.
Example: 1752139200000000000

Example (body)

{
  "event": "fill",
  "market": "BTC-EUR",
  "orderId": "80b5f04d-21fc-4ebe-9c5f-6d34f78ee477",
  "clientOrderId": "2be7d0df-d8dc-7b93-a550-8876f3b393e9",
  "operatorId": 543462,
  "fillId": "15d14b09-389d-4f83-9413-de9d0d8e7715",
  "timestamp": 1542967486256,
  "amount": "0.005",
  "side": "sell",
  "price": "5000.1",
  "taker": true,
  "fee": "0.03",
  "feeCurrency": "EUR",
  "timestampNs": 1752139200000000000
}