Guides
SupportStatusSign UpLogin

Asset Aggregation & Portfolio Analysis

Get a complete view of a wallet’s holdings across multiple blockchains. Track fungible tokens, native coins, NFTs, and multi-tokens in one consolidated portfolio using Tatum’s Get Wallet Portfolio endpoint, simplifying auditing, compliance, and investment tracking.

Understanding a wallet’s complete holdings is crucial for auditing, compliance, and investment tracking. Tatum’s Get Wallet Portfolio endpoint provides a consolidated view of all assets across multiple blockchains.

Why Wallet Portfolio Matters?

  • Multi-Chain Holdings – Consolidate assets across Ethereum, BSC, Polygon, and other supported chains.
  • Token & NFT Tracking – Track fungible tokens, native coins, NFTs, and multi-tokens in a single view.
  • Portfolio Insights – Quickly understand asset composition, liquidity, and performance.
  • Compliance & Tax Reporting – Aggregated data simplifies regulatory and tax reporting.

A complete wallet portfolio snapshot reduces errors and saves time when monitoring assets.

Tatum Data API: Get Wallet Portfolio

📘

Get Wallet Portfolio (Popular🔥)

GET /v4/wallet/portfolio/{address}
Fetch the complete portfolio of assets (tokens, NFTs, coins) for a wallet.
Explore Docs →

cURL Example to get wallet portfolio

curl -X GET \
     --url 'https://api.tatum.io/v4/data/wallet/portfolio?chain=ethereum-mainnet&addresses=0x055D9A4dc18687872D95E2324335AAa4fbd29F05&tokenTypes=fungible' \
     --header 'accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'

const options = {
  method: 'GET',
  headers: {
    accept: 'application/json',
    'x-api-key': 'YOUR_API_KEY'
  }
};

fetch('https://api.tatum.io/v4/data/wallet/portfolio?chain=ethereum-mainnet&tokenTypes=native', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

Response Example:

{
  "result": [
    {
      "chain": "ethereum-mainnet",
      "address": "0x055D9A4dc18687872D95E2324335AAa4fbd29F05",
      "balance": "2",
      "denominatedBalance": "2000000000000000000",
      "decimals": 18,
      "tokenAddress": "0x10d280e9f1c91c84fa1a1f03c1b247c198822a0d",
      "type": "fungible"
    },
    {
      "chain": "ethereum-mainnet",
      "address": "0x055D9A4dc18687872D95E2324335AAa4fbd29F05",
      "balance": "0.005",
      "denominatedBalance": "5000000000000000",
      "decimals": 18,
      "tokenAddress": "0x115ec79f1de567ec68b7ae7eda501b406626478e",
      "type": "fungible"
    }
  ],
  "prevPage": "",
  "nextPage": ""
}

How to use wallet endpoint?

  1. Select Wallet Address – Identify which wallets to track.
  2. Call Get Wallet Portfolio – Use the Tatum endpoint with tokenTypes to fetch the desired assets.
  3. Filter & Aggregate – Optionally filter by chain or asset type (fungible, native, nft, multitoken).
  4. Analyze & Report – Calculate total value, asset distribution, or generate audit/compliance reports.

Practical Use Cases

  • Portfolio Snapshot – Quickly see all assets in one place.
  • Cross-Chain Tracking – Aggregate holdings across multiple blockchains.
  • Audit & Compliance – Use portfolio data to support regulatory reporting.
  • Investment Analysis – Track asset composition and performance over time.

Asset Aggregation & Portfolio Analysis – FAQs

What is wallet asset aggregation?

Asset aggregation means collecting all coins, tokens, and NFTs that a wallet holds — across one or many blockchains — and presenting them in a single consolidated view. Tatum’s Wallet Portfolio API eliminates the need to query each contract or chain manually.

Which asset types are included in the portfolio response?
  • native – the wallet’s main coin balance (e.g. ETH, BTC, MATIC)
  • fungible – ERC-20 / BEP-20 / SPL tokens and stablecoins
  • nft – ERC-721 NFTs with collection and token-ID data
  • multitoken – ERC-1155 multi-token holdings

You can filter by tokenTypes or fetch all at once for a full portfolio snapshot.

Can I query multiple wallets or chains in one call?

Yes. Provide a comma-separated list of wallet addresses to fetch their balances together, or call the API per chain if you want chain-specific breakdowns. This helps portfolio trackers display holdings across Ethereum, Polygon, Solana, Tron, BSC, and more.

How do I enrich portfolio data with token or NFT metadata?

Use the Token API to fetch each token’s name, symbol, decimals, and total supply. For NFTs, call the NFT API (optionally with a tokenId) to get collection info and metadata like the NFT’s name or image URL. This lets you display user-friendly portfolio cards instead of raw contract addresses.

How do I show fiat values for each asset in the portfolio?

Combine the portfolio response with live prices from the Exchange Rate API. For each asset’s symbol or contract, fetch its current price in USD, EUR, or any supported fiat, then multiply by the token balance to display total value.

How often should I refresh portfolio data?

For real-time dashboards, poll or subscribe to changes every few seconds to minutes, depending on app requirements. For analytics or periodic reporting (like end-of-day snapshots), fetch at scheduled intervals. Use caching to avoid repeated look-ups of static token metadata.

How does portfolio aggregation help with compliance or reporting?

Portfolio aggregation provides a complete snapshot of all assets held by a wallet at a point in time. Auditors and tax professionals can pair this with Historical Balances to track changes over periods, or with Malicious Address Checks to screen counterparties and assets for risk.

What are best practices for scaling portfolio apps?
  • Cache token & NFT metadata to reduce repeat look-ups.
  • Batch wallet queries or run them in parallel for faster refresh.
  • Use the Notifications service to subscribe to wallet events instead of heavy polling.
  • Combine with historical balances for accurate point-in-time snapshots.

Notes

  • Can fetch multiple wallets at once by providing comma-separated addresses.
  • Supports all asset types: fungible tokens, native coins, NFTs, and multi-tokens.
  • Combine with historical balances for performance tracking or tax reporting.

With Get Wallet Portfolio, your system can aggregate wallet assets, gain a complete view of holdings, and support auditing, compliance, or investment monitoring.

Updated 17 days ago