Trades subscription

REQUEST wss://ws-mdpro.bitvavo.com/v2 trades

Subscribes to events that return data when a trade is made.

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: trades
marketsstring[]
The markets for which you want stream the data.
Example: ["BTC-EUR"]
]

Example (body)

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

Response

Trades confirmation

Schema

Schema

eventstring
The returned event.
Example: subscribed
subscriptions object
The object with all currently active subscriptions.
tradesstring[]
The markets for which to stream trades.
Example: ["BTC-EUR"]

Example (body)

{
  "event": "subscribed",
  "subscriptions": {
    "trades": [
      "BTC-EUR"
    ]
  }
}

Trades event

Schema

Schema

eventstring
The returned event.
Example: trade
idstring
The unique identifier of a trade.
Example: 391f4d94-485f-4fb0-b11f-39da1cfcfc2d
amountstring
The amount of base currency exchanged in the trade.
Example: 0.00096361
pricestring
The price in quote currency for which the trade was made.
Example: 9311.2
timestampinteger
The Unix timestamp in milliseconds of when the trade was made.
Example: 1566817150381
marketstring
The market in which the trade occurred.
Example: BTC-EUR
sidestring
Indicates if the taker made the order to buy or sell an asset.
Possible values: [sell, buy]
timestampNsinteger
The Unix timestamp in nanoseconds of when the trade was made.
Example: 1752139200000000000

Example (body)

{
  "event": "trade",
  "id": "391f4d94-485f-4fb0-b11f-39da1cfcfc2d",
  "amount": "0.00096361",
  "price": "9311.2",
  "timestamp": 1566817150381,
  "market": "BTC-EUR",
  "side": "sell",
  "timestampNs": 1752139200000000000
}