Get transaction history

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

Returns a list of past transactions for your account or the specified date range. If the range is not specified, returns all past transactions.

info

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

Rate limit weight points: 1

Request

Schema

Body

actionstring

Set value to privateGetTransactionHistory.

Example: privateGetTransactionHistory

requestIdstring

Your identifier for the request.

Example: 1

fromDateinteger

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

Example: 1751328000000

toDateinteger

The Unix timestamp in milliseconds up to which to return transactions.

Example: 1754006399000

pageinteger

The page number for the transaction history.

Possible values: >= 1

Example: 1

maxItemsinteger

The maximum number of items per page in the transaction history.

Possible values: >= 1 and <= 100

Example: 100

typestring

The type of transaction to return.

Possible values: [sell, buy, staking, fixed_staking, deposit, withdrawal, affiliate, distribution, internal_transfer, withdrawal_cancelled, rebate, loan, external_transferred_funds, manually_assigned]

Example (body)

{
  "action": "privateGetTransactionHistory",
  "requestId": 1,
  "fromDate": 1751328000000,
  "toDate": 1754006399000,
  "page": 1,
  "maxItems": 100,
  "type": "sell"
}

Response

Schema

Schema

actionstring
The action performed.
Example: privateGetTransactionHistory
requestIdinteger
Your identifier for the request.
Example: 1
response object
currentPageinteger
The current page number.
Example: 1
totalPagesinteger
The total number of returned pages.
Example: 1
maxItemsinteger
The maximum number of transactions per page.
Example: 100
items object[]
Array [
transactionIdstring
The unique identifier of the transaction.
Example: 5f5e7b3b-4f5b-4b2d-8b2f-4f2b5b3f5e5f
executedAtstring<date-time>
The Unix timestamp when the transaction was executed.
Example: 2021-01-01T00:00:00.000Z
typestring
The type of transaction.
Possible values: [sell, buy, staking, fixed_staking, deposit, withdrawal, affiliate, distribution, internal_transfer, withdrawal_cancelled, rebate, loan, external_transferred_funds, manually_assigned, manually_assigned_bitvavo]
priceCurrencystring
The currency in which the transaction was made.
Example: EUR
priceAmountstring
The amount of the transaction.
Example: 1000.00
sentCurrencystring
The currency that was sent in the transaction.
Example: EUR
sentAmountstring
The amount that was sent in the transaction.
Example: 0.1
receivedCurrencystring
The currency that was received in the transaction.
Example: BTC
receivedAmountstring
The amount that was received in the transaction.
Example: 0.0001
feesCurrencystring
The currency in which the fees were paid.
Example: EUR
feesAmountstring
The amount of fees paid in the transaction.
Example: 0.01
addressstringnullable
The address where the transaction was made.
]

Example (body)

{
  "action": "privateGetTransactionHistory",
  "requestId": 1,
  "response": {
    "currentPage": 1,
    "totalPages": 1,
    "maxItems": 100,
    "items": [
      {
        "transactionId": "5f5e7b3b-4f5b-4b2d-8b2f-4f2b5b3f5e5f",
        "executedAt": "2021-01-01T00:00:00.000Z",
        "type": "sell",
        "priceCurrency": "EUR",
        "priceAmount": "1000.00",
        "sentCurrency": "EUR",
        "sentAmount": "0.1",
        "receivedCurrency": "BTC",
        "receivedAmount": "0.0001",
        "feesCurrency": "EUR",
        "feesAmount": "0.01",
        "address": "string"
      }
    ]
  }
}