Get trades

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

Returns trades for the specified market and time period made by all Bitvavo users. The returned trades are sorted by their timestamp in a descending order, from the latest to the earliest.

Rate limit weight points: 5

Request

Schema

Body

actionstring

Set value to getTrades.

Example: getTrades

requestIdinteger

Your identifier for the request.

Example: 1

marketstringrequired

The market for which to return the trades.

Example: BTC-EUR

limitinteger

The maximum number of trades to return.

Possible values: >= 1 and <= 1000

Default value: 500

startinteger

The Unix timestamp in milliseconds starting from which to return trades.

Example: 1751541801000

endinteger

The Unix timestamp in milliseconds until which to return trades.


Cannot be more than 24 hours after the start timestamp.

Example: 1751548920000

tradeIdFromstring

The unique identifier of the trade starting from which to return the trades.

tradeIdTostring

The unique identifier of the trade up to which to return the trades.

Example (body)

{
  "action": "getTrades",
  "requestId": 1,
  "market": "BTC-EUR",
  "limit": 500,
  "start": 1751541801000,
  "end": 1751548920000,
  "tradeIdFrom": "string",
  "tradeIdTo": "string"
}

Response

Schema

Schema

actionstring

The action performed.

Example: getTrades

requestIdinteger

Your identifier for the request.

Example: 1

response object

idstring

The unique identifier of the trade.

Example: 57b1159b-6bf5-4cde-9e2c-6bd6a5678baf

timestampinteger

The Unix timestamp in milliseconds when the trade was made.

Example: 1542967486256

amountstring

The amount of base currency exchanged in the trade. For example, 0.1 Bitcoin.

Example: 0.1

pricestring

The price of 1 unit of base currency in the amount of quote currency at the time of the trade. For example, 34243 Euro.

Example: 34243

sidestring

Indicates if the taker, who fills the order, is selling or buying.

Possible values: [sell, buy]

Example (body)

{
  "action": "getTrades",
  "requestId": 1,
  "response": {
    "id": "57b1159b-6bf5-4cde-9e2c-6bd6a5678baf",
    "timestamp": 1542967486256,
    "amount": "0.1",
    "price": "34243",
    "side": "sell"
  }
}