---
updatedAt: 2025-11-17T05:24:27.000Z
agentTools:
  projectIndex: https://docs.tatum.io/llms.txt
---

# 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:fire:)**
>
> `GET /v4/wallet/portfolio/{address}`\
> Fetch the complete portfolio of assets (tokens, NFTs, coins) for a wallet.\
> [Explore Docs →](https://docs.tatum.io/reference/getwalletportfoliov4)

### cURL Example to get wallet portfolio

```curl
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'
```
```javascript
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:

```json
{
  "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

<HTMLBlock>{`
<div class="product-faq" itemscope itemtype="https://schema.org/FAQPage">

  
  <div itemscope itemprop="mainEntity" itemtype="https://schema.org/Question">
    <details>
      <summary itemprop="name">What is wallet asset aggregation?</summary>
      <div itemscope itemprop="acceptedAnswer" itemtype="https://schema.org/Answer">
        <div itemprop="text">
          <p>
            Asset aggregation means collecting all <strong>coins, tokens, and NFTs</strong> that a wallet holds
            — across one or many blockchains — and presenting them in a single consolidated view.
            Tatum’s <strong>Wallet Portfolio API</strong> eliminates the need to query each contract or chain manually.
          </p>
        </div>
      </div>
    </details>
  </div>

  
  <div itemscope itemprop="mainEntity" itemtype="https://schema.org/Question">
    <details>
      <summary itemprop="name">Which asset types are included in the portfolio response?</summary>
      <div itemscope itemprop="acceptedAnswer" itemtype="https://schema.org/Answer">
        <div itemprop="text">
          <ul>
            <li><strong>native</strong> – the wallet’s main coin balance (e.g. ETH, BTC, MATIC)</li>
            <li><strong>fungible</strong> – ERC-20 / BEP-20 / SPL tokens and stablecoins</li>
            <li><strong>nft</strong> – ERC-721 NFTs with collection and token-ID data</li>
            <li><strong>multitoken</strong> – ERC-1155 multi-token holdings</li>
          </ul>
          <p>
            You can filter by <code>tokenTypes</code> or fetch all at once for a full portfolio snapshot.
          </p>
        </div>
      </div>
    </details>
  </div>

  
  <div itemscope itemprop="mainEntity" itemtype="https://schema.org/Question">
    <details>
      <summary itemprop="name">Can I query multiple wallets or chains in one call?</summary>
      <div itemscope itemprop="acceptedAnswer" itemtype="https://schema.org/Answer">
        <div itemprop="text">
          <p>
            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.
          </p>
        </div>
      </div>
    </details>
  </div>

  
  <div itemscope itemprop="mainEntity" itemtype="https://schema.org/Question">
    <details>
      <summary itemprop="name">How do I enrich portfolio data with token or NFT metadata?</summary>
      <div itemscope itemprop="acceptedAnswer" itemtype="https://schema.org/Answer">
        <div itemprop="text">
          <p>
            Use the <a href="/reference/token-api">Token API</a> to fetch each token’s name, symbol, decimals,
            and total supply.  
            For NFTs, call the <a href="/reference/nft-api">NFT API</a> (optionally with a <code>tokenId</code>)
            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.
          </p>
        </div>
      </div>
    </details>
  </div>

  
  <div itemscope itemprop="mainEntity" itemtype="https://schema.org/Question">
    <details>
      <summary itemprop="name">How do I show fiat values for each asset in the portfolio?</summary>
      <div itemscope itemprop="acceptedAnswer" itemtype="https://schema.org/Answer">
        <div itemprop="text">
          <p>
            Combine the portfolio response with live prices from the
            <a href="/docs/exchange-rates">Exchange Rate API</a>.  
            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.
          </p>
        </div>
      </div>
    </details>
  </div>

  
  <div itemscope itemprop="mainEntity" itemtype="https://schema.org/Question">
    <details>
      <summary itemprop="name">How often should I refresh portfolio data?</summary>
      <div itemscope itemprop="acceptedAnswer" itemtype="https://schema.org/Answer">
        <div itemprop="text">
          <p>
            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.
          </p>
        </div>
      </div>
    </details>
  </div>

  
  <div itemscope itemprop="mainEntity" itemtype="https://schema.org/Question">
    <details>
      <summary itemprop="name">How does portfolio aggregation help with compliance or reporting?</summary>
      <div itemscope itemprop="acceptedAnswer" itemtype="https://schema.org/Answer">
        <div itemprop="text">
          <p>
            Portfolio aggregation provides a <strong>complete snapshot</strong> of all assets
            held by a wallet at a point in time.  
            Auditors and tax professionals can pair this with
            <a href="/docs/historical-balances">Historical Balances</a>
            to track changes over periods, or with
            <a href="/docs/fraud-detection-compliance">Malicious Address Checks</a>
            to screen counterparties and assets for risk.
          </p>
        </div>
      </div>
    </details>
  </div>

  
  <div itemscope itemprop="mainEntity" itemtype="https://schema.org/Question">
    <details>
      <summary itemprop="name">What are best practices for scaling portfolio apps?</summary>
      <div itemscope itemprop="acceptedAnswer" itemtype="https://schema.org/Answer">
        <div itemprop="text">
          <ul>
            <li>Cache token &amp; NFT metadata to reduce repeat look-ups.</li>
            <li>Batch wallet queries or run them in parallel for faster refresh.</li>
            <li>Use the <strong>Notifications</strong> service to subscribe to wallet events instead of heavy polling.</li>
            <li>Combine with historical balances for accurate point-in-time snapshots.</li>
          </ul>
        </div>
      </div>
    </details>
  </div>

</div>
`}</HTMLBlock>

## 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.