Skip to main content

Get trade history

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

Returns the specified number of past trades for your account and a time period of up to 24 hours. Does not return trades with a Price Guarantee.

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

info

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

tip

To get a specific list of trades, use the start, end, tradeIdFrom, and tradeIdTo parameters.

tip

To get all past transactions for your account, use the privateGetTransactionHistory message.

Rate limit weight points: 5

Request​

Body
    actionstring

    Set value to privateGetTrades.

    Example: privateGetTrades
    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.

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

    Example: 1751541801000
    endinteger

    The Unix timestamp in milliseconds until which to return trades.

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

    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.

Response​

Schema
    actionstring

    The action performed.

    Example: privateGetTrades
    requestIdinteger

    Your identifier for the request.

    Example: 1
    response object
    idstring

    The identifier of the fill, unique per market. Different markets can use the same id values.

    Example: 108c3633-0276-4480-a902-17a01829deae
    orderIdstring<UUID>

    Bitvavo identifier of the order that was filled.

    Example: 1d671998-3d44-4df4-965f-0d48bd129a1b
    clientOrderIdstring<UUID>

    Your identifier of the order that was filled.

    Example: 2be7d0df-d8dc-7b93-a550-8876f3b393e9
    timestampinteger

    The Unix timestamp in milliseconds when the trade was made.

    Example: 1542967486256
    marketstring

    The market for which to return past trades.

    Example: BTC-EUR
    sidestring

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

    Possible values: [buy, sell]

    amountstring

    The amount of base currency exchanged in the trade.

    Example: 0.005
    pricestring

    The price of 1 unit of base currency in the amount of quote currency at the time of the trade.

    Example: 5000.1
    takerboolean

    Indicates whether you are the taker for the fill.

    Example: true
    feestring

    The fee that was paid. Value is negative for rebates. Only available if settled is true.

    Example: 0.03
    feeCurrencystring

    Currency in which the fee was paid. Only available is settled is true.

    Example: EUR
    settledboolean

    Indicates whether the fee was deducted and the exchanged currency is available for further trading.