Ticker subscription

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

Subscribes to ticker events which return an object every time the best bid or ask changes.

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

Example (body)

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

Response

Ticker confirmation

Schema

Schema

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

Example (body)

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

Ticker event

Schema

Schema

eventstring
The returned event.
Example: ticker
marketstring
The market to which you subscribed.
Example: BTC-EUR
bestBidstring
The highest offered price for the asset.
Example: 9156.8
bestBidSizestring
The size of the bestBid.
Example: 0.12840531
bestAskstring
The lowest asked price for the asset.
Example: 9157.9
bestAskSizestring
The size of the bestAsk.
Example: 0.1286605
lastPricestring
The last price at which a trade occurred.
Example: 9156.9

Example (body)

{
  "event": "ticker",
  "market": "BTC-EUR",
  "bestBid": "9156.8",
  "bestBidSize": "0.12840531",
  "bestAsk": "9157.9",
  "bestAskSize": "0.1286605",
  "lastPrice": "9156.9"
}