Skip to main content

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.

The Get Crypto Holdings 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, Ethereum, BNB Chain, Base, and more. You can also query multiple wallets in the same query.

​
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 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:

​
Walkthrough to Get Wallet Portfolio

​
1. Prepare your query

The wallet/portfolio endpoint supports one or multiple wallets:
ParameterDescription
walletSingle wallet address to query (can also accept comma-separated addresses). Required if wallets is not provided.
walletsComma-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 or 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 Wallet Portfolio Demo UI Docs

​
Summary

The Get Crypto Holdings 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