Skip to main content

Get trade history

GET 
/trades

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

This is a private endpoint. To send requests, you need to authenticate.

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 Get transaction history request.

Rate limit weight points: 5

Request​

Query Parameters

    market stringrequired

    The market for which to return the past trades.

    Example: BTC-EUR
    limit integer

    Possible values: >= 1 and <= 1000

    The maximum number of trades to return, from latest to earliest.

    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 up to 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.

    tradeId stringdeprecated

    Deprecated: tradeId is interpreted as tradeIdTo. If used, returns all trades up to this tradeId.

Responses​

The request was successful.

Schema
  • Array [
    • 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<unix-timestamp in milliseconds>

    The Unix timestamp 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.

  • ]