Skip to main content

Get trades

GET 
/{market}/trades

Returns the list of trades made by all Bitvavo users for the specified market and time period up to 24 hours.

The returned trades are sorted by their timestamp in a descending order, from the latest to the earliest.

info

This is a public endpoint. However, authenticating your request gives you a higher rate limit.

tip

To get the list of your past trades, make a Get trades history request.

Rate limit weight points: 5

Request​

Path Parameters

    market stringrequired

    The market for which to return the trades.

    Example: BTC-EUR

Query Parameters

    limit integer

    Possible values: >= 1 and <= 1000

    The maximum number of trades to return.

    Default value: 500
    start unix-timestamp in milliseconds

    Possible values: >= 0

    The Unix timestamp starting from which to return trades.

    Can only return trades for a period of up to 24 hours.

    end unix-timestamp in milliseconds

    Possible values: <= 8640000000000000

    The Unix timestamp until which to return trades.

    Cannot be more than 24 hours after the start parameter. Can only return trades for a period of up to 24 hours.

    tradeIdFrom string

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

    tradeIdTo string

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

Responses​

The request was successful.

Schema
  • Array [
    • idstring

    The unique identifier of the trade.

    Example: 57b1159b-6bf5-4cde-9e2c-6bd6a5678baf
    timestampinteger<unix-timestamp in milliseconds>

    The Unix timestamp 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: 34,243
    sidestring

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

    Possible values: [sell, buy]

  • ]