Historical Balances

Understanding how wallet balances have changed over time is essential for tax reporting, auditing, and portfolio tracking. Tatum’s Get Historical Wallet Balances endpoint lets you fetch the native token balance of one or more addresses at a specific block or timestamp.

📘

Get Historical Balances (Popular🔥)

GET /v4/data/wallet/balance/time
Fetch the complete portfolio of assets (tokens, NFTs, coins) for a wallet.
Explore Docs →

Example cURL Request

curl --request GET \
     --url 'https://api.tatum.io/v4/data/wallet/balance/time?chain=ethereum-mainnet&addresses=0x80d8bac9a6901698b3749fe336bbd1385c1f98f2%2C0xAe680Ed83baF08a8028118Bd19859F8a0E744cc6' \
     --header 'accept: application/json' \
     --header 'x-api-key: t-66a730ccccfd17001c479705-2f597d14ad7543f289a03418'

Sample Response

{
  "result": [
    {
      "chain": "ethereum-mainnet",
      "address": "0x80d8bac9a6901698b3749fe336bbd1385c1f98f2",
      "balance": "0",
      "lastUpdatedBlockNumber": 16499510,
      "type": "native"
    },
    {
      "chain": "ethereum-mainnet",
      "address": "0xAe680Ed83baF08a8028118Bd19859F8a0E744cc6",
      "balance": "0.036638040392209662",
      "lastUpdatedBlockNumber": 16499510,
      "type": "native"
    }
  ],
  "prevPage": "",
  "nextPage": ""
}

Practical Use Cases

1. Track Historical Portfolio Value
   Determine wallet balances at any point in time to calculate asset growth or historical holdings.

2. Audit & Compliance
   Verify that balances at specific blocks match reported transactions for auditing purposes.

3. Tax Reporting
   Accurately compute capital gains or losses by fetching balances at key dates or block numbers.

By integrating this endpoint, you can reconstruct wallet balances over time, enabling precise auditing, compliance, and portfolio analysis workflows.