wallet or wallets must be provided."true", "false").| Parameter | Required | Description |
|---|---|---|
wallet | Cond. | Single wallet address to query. |
wallets | Cond. | Comma-separated wallet addresses to query in aggregate. |
blockchains | Cond. | Comma-separated list of chains (e.g., ethereum,base). By default, only premium chains are queried (see list below). For optimal performance and fastest response times, we strongly recommend specifying only the blockchains you need. To query all chains, use fetchAllChains=true. |
asset | Cond. | Filter the net worth history to a specific asset (symbol or contract address) for the given wallet(s). |
cache | Cond. | "true" to allow returning cached results (faster responses). |
stale | Cond. | Number of seconds to allow cached data before refreshing. Example: 3600 = 1 hour. |
from | Cond. | Start of the historical window (Unix ms timestamp or ISO 8601). |
to | Cond. | End of the historical window (Unix ms timestamp or ISO 8601). |
unlistedAssets | Cond. | "true" to include unlisted or non-indexed assets in the calculation. |
period | Cond. | Supported values: 5min, 15min, 1h, 6h, 1d, 7d. Defines aggregation granularity. |
accuracy | Cond. | By default, to optimize response time, we will skip analyzing assets that make < 1% of the total net worth. You can set this to true` to analyze all assets. |
testnet | Cond. | "true" to include testnet data. |
minliq | Cond. | Minimum liquidity threshold in USD (default: 1000). Assets below are excluded. |
filterSpam | Cond. | "true" to remove spam or low-quality assets from results. |
fetchUntrackedHistory | Cond. | "true" to fetch historical prices for untracked assets. |
fetchAllChains | Cond. | "true" to query all supported chains, including those without premium RPCs. By default, only premium chains are queried. |
ethereum (Ethereum Mainnet)base (Base)arbitrum (Arbitrum One)polygon (Polygon PoS)avalanche (Avalanche C-Chain)bnb (BNB Smart Chain)optimism (Optimism)sonic (Sonic)blockchains parameter (e.g., blockchains=ethereum,base). This reduces latency and improves query efficiency.
To query all supported chains (including non-premium ones), use fetchAllChains=true.
0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee always indicates the native token of the chain referenced by chainId (e.g., evm:42161 = ETH on Arbitrum, evm:8453 = ETH on Base). Mobula normalizes native balances under this canonical placeholder so that the asset is easily identifiable across chains.0x82af49447d8a07e3bd95bd0d56f35241523fbab1, while the canonical WETH contract on both Base and Optimism is 0x4200000000000000000000000000000000000006.0xeeee...) and another for any wrapped balance. This lets you distinguish spendable gas from ERC-20-wrapped liquidity.0x57d7b62c7b877f315b2d0cac98c4775f5bd3cd0b on Arbitrum:
address field to decide whether a position is the native token placeholder or a wrapped contract so you can interpret balances correctly in your integration.