Get wallet balance chart
This endpoint returns a portfolio balance chart for a wallet. 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 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
Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.
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 - 7The web3 wallet address. Must be a valid EVM or Solana address. Returns 400 if the address is not tracked by Zerion. A wallet address, which can be either an EVM or Solana address
^0x[a-fA-F0-9]{40}$"0x42b9df65b219b3dd36ff330a4dd8f327a6ada990"
Query Parameters
Denominated 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