> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mobula.io/llms.txt
> Use this file to discover all available pages before exploring further.

# How to View Wallet Portfolio Holdings Across Ethereum, Solana, BNB, Base & More

> Use the Wallet Portfolio endpoint to retrieve a wallet’s holdings and see all assets inside it.

The [**Get Crypto Holdings**](https://docs.mobula.io/rest-api-reference/endpoint/wallet-portfolio) endpoint lets you retrieve a wallet’s holdings and view all assets inside it in a single request.

This is one of the simplest ways to inspect wallet portfolios across chains like [Solana](https://docs.mobula.io/blockchains/solana), [Ethereum](https://docs.mobula.io/blockchains/ethereum), [BNB Chain](https://docs.mobula.io/blockchains/bsc), [Base](https://docs.mobula.io/blockchains/base), and more.
You can also query multiple wallets in the same query.

***

<div style={{ position: 'relative', paddingBottom: '56.25%', height: 0, overflow: 'hidden' }}>
  <iframe src="https://www.youtube.com/embed/VzRWsfznuTk" title="YouTube video player" style={{ position: 'absolute', top: 0, left: 0, width: '100%', height: '100%', border: 0 }} allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowFullScreen />
</div>

***

## What this endpoint does

With this API, you can:

* Retrieve all holdings and assets for a wallet portfolio
* Query a single wallet or multiple wallets in one request
* Return per-asset balances, estimated USD value, and allocation breakdown
* Optionally filter spam assets and exclude low-liquidity tokens
* Include 24h price change data for monitoring

***

## What you’ll need

* A wallet address (or multiple wallets)
* A Mobula API key

Note: All Mobula endpoints require an API key.\
Get a free API key: [Here](https://admin.mobula.io/)

Optional:

* DexScreener (to find active wallets to test)

***

## When to use Wallet Portfolio

Use this endpoint when you want to:

* Display a wallet’s current holdings and portfolio composition
* Combine multiple wallets into one aggregated portfolio view
* Filter results by chain for faster responses
* Remove spam assets and exclude low-liquidity tokens
* Add optional 24-hour price change data for monitoring

This endpoint returns holdings only. For realized/unrealized gains, use:

* [`/wallet/positions`](https://docs.mobula.io/rest-api-reference/endpoint/wallet-positions)
* [`/wallet/position`](https://docs.mobula.io/rest-api-reference/endpoint/wallet-position)

***

## Walkthrough to Get Wallet Portfolio

### 1. Prepare your query

The `wallet/portfolio` endpoint supports one or multiple wallets:

| Parameter | Description                                                                                                        |
| --------- | ------------------------------------------------------------------------------------------------------------------ |
| `wallet`  | Single wallet address to query (can also accept comma-separated addresses). Required if `wallets` is not provided. |
| `wallets` | Comma-separated wallet addresses to query in aggregate. Required if `wallet` is not provided.                      |

Optional parameters you can use:

* `blockchains`: Comma-separated list of chains (example: `ethereum,base`)\
  Tip: For fastest responses, specify only the chains you need, such as [Solana](https://docs.mobula.io/blockchains/solana) or [Ethereum](https://docs.mobula.io/blockchains/ethereum).
* `fetchAllChains`: `"true"` to query all supported chains
* `cache`: `"true"` to allow cached results (faster responses)
* `stale`: Number of seconds to allow cached data before refreshing (example: `3600`)
* `unlistedAssets`: `"true"` to include unlisted or non-indexed assets in the calculation.
* `accuracy`: Set to `"maximum"` to analyze all assets (may increase response time)
* `minliq`: Minimum liquidity threshold in USD (example: `10000`)
* `filterSpam`: `"true"` to remove spam or low-quality assets
* `shouldFetchPriceChange`: Set to `"24h"` to include 24-hour price change data
* `fetchEmptyBalances`: `"true"` to include tokens with zero balance
* `testnet`: `"true"` to include testnet data
* `backfillTransfers`: `"true"` to trigger transfer backfilling (returns `backfill_status`)

### 2. Find a wallet address to test

To retrieve real wallet data:

* Open DexScreener
* Pick any token
* Click **Top Traders**
* Select an active wallet
* Open it in the blockchain explorer
* Copy the wallet address

This address is used as the `wallet` parameter.

### 3. Fill the API form

Once your wallet address is ready:

* Paste it into the `wallet` field
* (Optional) add chain filters like `blockchains=solana`
* Set spam filtering or liquidity thresholds if needed
* Click **Send** to retrieve the wallet portfolio holdings

***

## Reviewing the response

Each asset returned represents a holding found in the wallet portfolio.

Key fields include:

* `price`: Current price in USD
* `token_balance`: Total token amount held
* `estimated_balance`: Estimated USD value (`token_balance × price`)
* `allocation`: Percentage share of total portfolio value
* `liquidity`: Total liquidity across DEX pools
* `price_change_24h`: Returned when `shouldFetchPriceChange=24h` is enabled
* `contracts_balances`: Detailed breakdown per chain and contract
* `cross_chain_balances`: Aggregated balances per blockchain
* `wallets`: Wallet addresses holding the asset (useful for multi-wallet queries)

***

## Try It Live with Mobula Wallet Portfolio Demo (UI)

[Demo UI Homepage](https://mobula-demo-endpoint-production.up.railway.app/)

[Wallet Portfolio Demo UI](https://mobula-demo-endpoint-production.up.railway.app/wallet-portfolio)

[Docs](https://docs.mobula.io/rest-api-reference/endpoint/wallet-portfolio)

***

## Summary

The [**Get Crypto Holdings**](https://docs.mobula.io/rest-api-reference/endpoint/wallet-portfolio) endpoint helps you:

* Retrieve wallet holdings and assets in one request
* Query single or multiple wallets in the same call
* Filter by chain, remove spam assets, and set liquidity thresholds
* Visualize results instantly in the demo UI

***

## Try Mobula for Free

Try our free API today and start building in minutes.\
Get your free API key: [Here](https://admin.mobula.io/)