Get wallet set balance chart
This endpoint returns a portfolio balance chart for a wallet set. A wallet set is represented by an EVM address, a Solana address, or both. At least one address must be provided. This is over a specified time period, based on the provided start and end timestamps. Results can be filtered by blockchain and asset type, offering flexible and detailed visualizations of wallet set performance, similar to what you see in the Zerion interface.
Complex positions. By default the chart counts only simple positions — token and native-coin balances held directly in the wallet. Set filter[positions] to only_complex or no_filter to also include complex DeFi protocol positions. Support is rolling out by protocol — currently Uniswap V2 LP, with Uniswap V3, Uniswap V4 (hookless pools), and Morpho vaults to follow. Unsupported position types are omitted from the chart.
Authorizations
Path Parameters
Chart period. Determines both the time window covered and the spacing
between chart points (points). Each period samples the window at a fixed
interval, so the number of points is roughly constant (~290–460) regardless
of period:
| Period | Point interval | Time window |
|---|---|---|
hour | 10 seconds | last 1 hour |
day | 5 minutes | last 24 hours |
week | 30 minutes | last 7 days |
month | 2 hours | last 30 days |
3months | 6 hours | last 90 days |
6months | 12 hours | last 180 days |
year | 1 day | last 365 days |
5years | 4 days | last 5 years |
max | varies | full available history |
Point counts are approximate, and begin_at / end_at are aligned to the
interval. For max, the interval is derived from the amount of available
history (targeting ~400 points), so it varies; for wallet and wallet-set
charts the spacing is at least 1 day.
hour, day, week, month, 3months, 6months, year, 5years, max 3 - 7Query Parameters
A list of wallet addresses forming a wallet set. example: 0x42b9df65b219b3dd36ff330a4dd8f327a6ada990,8BH9pjtgyZDC4iAQH5ZiYDZ1MDWC98xki2V8NzqqKW3K
The set must contain at least one address and may include at most one address per supported chain type (currently EVM and Solana). The order of addresses does not matter.
1 - 2 elementsDenominated currency value of returned prices
eth, btc, usd, eur, krw, rub, gbp, aud, cad, inr, jpy, nzd, try, zar, cny, chf Account only for balance on these chains (comma-separated list). Available chain ids can be found in chains endpoints.
25["aurora"]Account only for balance of given fungible assets (comma-separated list). Mutually exclusive with filter[exclude_fungible_ids] — combining both returns 400.
2544Exclude balance contributions from the given fungible assets (comma-separated list). Useful when the set you want to keep is large but the set you want to omit is small. Mutually exclusive with filter[fungible_ids] — combining both returns 400.
2544Which positions to include in the balance chart.
only_simple(default) — simple positions only: wallet token and native-coin balances.only_complex— complex DeFi protocol positions only (e.g. liquidity-pool and vault positions).no_filter— include both simple and complex positions.
Complex-position support is rolling out by protocol (currently Uniswap V2 LP).
only_simple, only_complex, no_filter