wallet sets

Get wallet set portfolio

Returns the portfolio overview of a wallet set, with the total value broken down by chain and by position type. A wallet set is one EVM address, one Solana address, or both. At least one is required.

Simple positions by default. filter[positions] defaults to only_simple, so the totals cover tokens held directly in the wallet and exclude DeFi protocol positions. Pass no_filter to have protocol positions counted too.

Solana limitation. Protocol positions are not supported for Solana addresses yet.

See also: Resource IDs

get/v1/wallet-sets/portfolio

Request

Base URL
https://api.zerion.io
URL
https://api.zerion.io/v1/wallet-sets/portfolio
Auth
HTTP basic

Query parameters

addressesstring[] required

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.

Returns 400 if an address in the set is not one Zerion tracks, such as a token contract, router or exchange hot wallet.

filter[positions]'only_simple' | 'only_complex' | 'no_filter'

Which positions count toward the portfolio totals. Defaults to only_simple.

only_simple - tokens and native coins held directly in the wallet. DeFi protocol positions are left out.
only_complex - DeFi protocol positions only, such as staked assets and liquidity pools (for example Uniswap or Aave).
no_filter - both simple and protocol positions.

Enterprise pricing can differ depending on the filter value. For details, contact api@zerion.io.

currency'eth' | 'btc' | 'usd' | 'eur' | 'krw' | 'rub' | 'gbp' | 'aud' | 'cad' | 'inr' | 'jpy' | 'nzd' | 'try' | 'zar' | 'cny' | 'chf'

Denominated currency value of returned prices

Response

Response for requested wallet set portfolio

Example response

{
  "links": {
    "self": "https://api.zerion.io/v1/wallet-sets/portfolio?addresses=0x42b9df65b219b3dd36ff330a4dd8f327a6ada990%2C8BH9pjtgyZDC4iAQH5ZiYDZ1MDWC98xki2V8NzqqKW3K&currency=eth&filter%5Bpositions%5D=no_filter"
  },
  "data": {
    "id": "0x42b9df65b219b3dd36ff330a4dd8f327a6ada990",
    "attributes": {
      "positions_distribution_by_type": {
        "wallet": 1864.774102420957,
        "deposited": 78.04192492782934,
        "borrowed": 0.9751475798305564,
        "locked": 5.780032725068765,
        "staked": 66.13183205505294
      },
      "positions_distribution_by_chain": {
        "arbitrum": 458.3555051522226,
        "aurora": 72.01031337463428,
        "avalanche": 17.128850607339444,
        "base": 55.01550749900544,
        "binance-smart-chain": 5.561075880033699,
        "celo": 31.293849330045006,
        "ethereum": 1214.009900354964,
        "fantom": 84.58514074264951,
        "linea": 8.258227109505139,
        "optimism": 573.032664994399,
        "polygon": 64.31407562634853,
        "xdai": 113.1679493137936,
        "zksync-era": 9.451002156306377
      },
      "total": {
        "positions": 2017.4858230069574
      },
      "changes": {
        "absolute_1d": 102.0271468171374,
        "percent_1d": 5.326512552079021
      }
    }
  }
}

Changes

No recorded changes to this operation across all 3 revisions of this API.