Skip to main content
GET
Get wallet balance chart

Authorizations

Authorization
string
header
required

To test endpoints here, paste your API key from the dashboard into the username field and leave the password empty.

Path Parameters

chart_period
enum<string>
default:day
required

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:

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.

Available options:
hour,
day,
week,
month,
3months,
6months,
year,
5years,
max
Required string length: 3 - 7
address
required

The 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

Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0x42b9df65b219b3dd36ff330a4dd8f327a6ada990"

Query Parameters

currency
enum<string>
default:usd

Denominated currency value of returned prices

Available options:
eth,
btc,
usd,
eur,
krw,
rub,
gbp,
aud,
cad,
inr,
jpy,
nzd,
try,
zar,
cny,
chf
filter[chain_ids]
string[]

Account only for balance on these chains (comma-separated list). Available chain ids can be found in chains endpoints.

Maximum array length: 25
Example:
filter[fungible_ids]
string[]

Account only for balance of given fungible assets (comma-separated list). Mutually exclusive with filter[exclude_fungible_ids] — combining both returns 400.

Maximum array length: 25
Maximum string length: 44
filter[exclude_fungible_ids]
string[]

Exclude 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.

Maximum array length: 25
Maximum string length: 44
filter[pool_addresses]
string[]

Restrict the balance chart to specific liquidity-pool / vault positions, identified by their contract address (comma-separated list) — the Uniswap V2 LP-token or ERC-4626 vault (e.g. Morpho) address. Only the matching protocol positions are charted; simple token and native-coin balances are excluded. These are complex (protocol) positions, so passing filter[positions]=only_simple alongside this filter returns 400. Mutually exclusive with filter[exclude_pool_addresses] — combining both returns 400.

Maximum array length: 25
Maximum string length: 44
filter[exclude_pool_addresses]
string[]

Exclude specific liquidity-pool / vault positions from the balance chart, identified by their contract address (comma-separated list) — the Uniswap V2 LP-token or ERC-4626 vault (e.g. Morpho) address. The matching positions are removed; the rest of the portfolio (including simple balances) is kept. These are complex (protocol) positions, so passing filter[positions]=only_simple alongside this filter — which would already drop every protocol position, making the exclusion a no-op — returns 400. Mutually exclusive with filter[pool_addresses] — combining both returns 400.

Maximum array length: 25
Maximum string length: 44
filter[positions]
enum<string>
default:only_simple

Which 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.

Uniswap V2 LP positions are supported today, and support for more protocols is rolling out over time.

Available options:
only_simple,
only_complex,
no_filter

Response

Resource for the requested wallet chart

data
object
required