Get deposit history

GET 
/depositHistory

Returns all past deposits for your account.

info

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

Rate limit weight points: 5

Request

Query Parameters

symbol string

The asset for which to return the deposit history. If not specified, all deposits are returned.

limit integer
Possible values: >= 1 and <= 1000
The maximum number of deposits 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 deposits.

end unix-timestamp in milliseconds

Possible values: <= 8640000000000000

The Unix timestamp up to which to return deposits.

Responses

200

The request was successful.

application/json

Schema

Schema

oneOf
Digital asset
timestampinteger<unix-timestamp in milliseconds>
The Unix timestamp 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
Fiat
timestampinteger<unix-timestamp in milliseconds>
The Unix timestamp 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. For example, NL89BANK0123456789.
Example: NL89BANK0123456789

Example - Digital asset

{
  "timestamp": 1706609321000,
  "symbol": "BTC",
  "amount": "0.99994",
  "address": "14qViLJfdGaP4EeHnDyJbEGQysnCpwk3gd",
  "paymentId": "10002653",
  "txId": "927b3ea50c5bb52c6854152d305dfa1e27fc01d10464cf10825d96d69d235eb3\n",
  "fee": "0.000063"
}

Example - Fiat

{
  "timestamp": 1706609321000,
  "symbol": "EUR",
  "amount": "500",
  "fee": "0",
  "status": "completed",
  "address": "NL89BANK0123456789"
}

4XX

For error codes, see Handle errors.