Get deposit history

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

Returns all past deposits for your account.

info

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

Rate limit weight points: 5

Request

Schema

Body

actionstringrequired
Set value to privateGetDepositHistory.
Example: privateGetDepositHistory
requestIdintegerrequired
Your identifier for the request.
Example: 1
symbolstring
The asset you want to deposit.
Example: BTC
limitinteger
The maximum number of deposits to return, from latest to earliest.
Possible values: >= 1 and <= 1000
Default value: 500
startinteger
The Unix timestamp in milliseconds starting from which to return deposits.
Example: 1751541801000
endinteger
The Unix timestamp in milliseconds up to which to return deposits.
Example: 1751548920000

Example (body)

{
  "action": "privateGetDepositHistory",
  "requestId": 1,
  "symbol": "BTC",
  "limit": 500,
  "start": 1751541801000,
  "end": 1751548920000
}

Response

Digital asset

Schema

Schema

actionstring
The action performed.
Example: privateGetDepositHistory
requestIdinteger
Your identifier for the request.
Example: 1
response object
timestampinteger
The Unix timestamp in milliseconds when the deposit was made.
Example: 1706609321000
symbolstring
The asset you deposited on Bitvavo.
Example: BTC
amountstring
The quantity of the asset you deposited on Bitvavo.
Example: 0.99994
addressstring
The address where you deposited assets.
Example: 14qViLJfdGaP4EeHnDyJbEGQysnCpwk3gd
paymentIdstring
The unique identifier of the deposit. Returned if specified in the request.
Example: 10002653
txIdstring
The unique identifier of the transaction on the blockchain.
Example: 927b3ea50c5bb52c6854152d305dfa1e27fc01d10464cf10825d96d69d235eb3
feestring
The transaction fee for a deposit on Bitvavo.
Example: 0.000063

Example (body)

{
  "action": "privateGetDepositHistory",
  "requestId": 1,
  "response": {
    "timestamp": 1706609321000,
    "symbol": "BTC",
    "amount": "0.99994",
    "address": "14qViLJfdGaP4EeHnDyJbEGQysnCpwk3gd",
    "paymentId": "10002653",
    "txId": "927b3ea50c5bb52c6854152d305dfa1e27fc01d10464cf10825d96d69d235eb3",
    "fee": "0.000063"
  }
}

Fiat

Schema

Schema

actionstring
The action performed.
Example: privateGetDepositHistory
requestIdinteger
Your identifier for the request.
Example: 1
response object
timestampinteger
The Unix timestamp in milliseconds when the deposit was made.
Example: 1706609321000
symbolstring
The currency you deposited on Bitvavo.
Example: EUR
amountstring
The quantity of the asset you deposited on Bitvavo.
Example: 500
feestring
The transaction fee for a deposit on Bitvavo.
Example: 0
statusstring
The state of the deposit. Can be completed or canceled.
Example: completed
addressstring
The bank account from which the deposit was made.
Example: NL89BANK0123456789

Example (body)

{
  "action": "privateGetDepositHistory",
  "requestId": 1,
  "response": {
    "timestamp": 1706609321000,
    "symbol": "EUR",
    "amount": "500",
    "fee": "0",
    "status": "completed",
    "address": "NL89BANK0123456789"
  }
}