Wallet Data & Portfolio Tracking

The Tatum Wallets API provides developers with a unified way to access wallet balances, historical balance snapshots, complete portfolios, and UTXO sets across supported blockchains.

It works seamlessly with both account-based blockchains (EVM chains like Ethereum, Polygon, BSC) and UTXO-based blockchains (Bitcoin, Litecoin, Dogecoin, etc.). This makes it a one-stop solution for wallet tracking, reporting, and transaction building.

Key Benefits of the Wallets API

Historical + real-time balance tracking – Monitor wallet balances at a specific time or current state.
Full portfolio visibility – Retrieve all fungible & non-fungible assets in one request.
UTXO management – Fetch spendable UTXOs for single or multiple addresses.
Cross-chain coverage – Works across both EVM and UTXO-based blockchains.
Optimized for scale – Batch queries let you monitor multiple wallets at once.

Wallets API Endpoints

The API offers four core endpoints depending on your use case.
Choose the method that best fits your application.

📚
Get Wallet Balance by Time
GET /v4/wallet/balance/{address}/time
Retrieve historical wallet balances at a specific timestamp.
Explore Docs →

📘
Get Wallet Portfolio (Popular:fire:)
GET /v4/wallet/portfolio/{address}
Fetch the complete portfolio of assets (tokens, NFTs, coins) for a wallet.
Explore Docs →

📚
Get UTXOs by Address
GET /v4/wallet/utxo/{address}
Retrieve all unspent transaction outputs (UTXOs) for a given wallet.
Explore Docs →

📚
Get UTXOs by Address Batch
POST /v4/wallet/utxo/batch
Fetch UTXOs for multiple wallet addresses in one request.
Explore Docs →

Wallets API FAQs

Which blockchains are supported for wallet queries?

The Wallets API supports all major blockchains available on Tatum, including:

Ethereum
Polygon
BNB Smart Chain
Solana
Bitcoin
Arbitrum
Optimism
Avalanche
Base
Celo

Can I query historical balances at a specific time?

Yes. The Get Wallet Balance by Time endpoint lets you retrieve the balance of a wallet at a given timestamp. This is useful for auditing, accounting, and compliance use cases.

Does the Wallets API provide a complete portfolio view?

Yes. The Get Wallet Portfolio endpoint aggregates a wallet’s full set of assets, including:

Native coins (e.g., ETH, BTC, SOL)
ERC-20 and other fungible tokens
NFTs and other digital collectibles

This provides a single, unified view of a user’s holdings across chains.

Does the Wallets API support UTXO-based blockchains?

Yes. The API provides two dedicated endpoints for UTXO-based chains (like Bitcoin, Litecoin, Dogecoin):

Get UTXOs by Address — retrieve unspent outputs for a single wallet
Get UTXOs by Address Batch — fetch UTXOs for multiple addresses in one request

This is especially useful for payment processors and exchanges needing to manage large sets of addresses.

What’s the difference between real-time and batch UTXO lookups?

Single address UTXO lookups are optimized for real-time queries, while batch lookups are more efficient when checking multiple addresses together. Use batch mode if you manage many addresses to save on requests and improve performance.

Use Cases for Developers

Build wallet trackers & explorers that show balances and holdings.
Enable exchanges & custodians to manage customer wallet UTXOs at scale.
Provide compliance & auditing tools with historical balance snapshots.
Power DeFi dashboards with portfolio and asset visibility.
Simplify transaction builders by retrieving spendable UTXOs.