What does the portfolio endpoint return?

Total net worth, value distribution by position type and by chain, and 1-day change — aggregated across every supported chain for one address.

How fresh is portfolio data?

Zerion indexes wallets continuously, so balances and valuations are returned in real time.

Does it include DeFi positions?

Yes. Use filter[positions] to include only simple wallet assets, only DeFi protocol positions, or both.

Which chains are covered?

A single call aggregates across 51+ EVM chains and Solana — no per-chain requests needed.

Wallet Portfolio API

Every Token, Position, and Chain in One Call

Get Started Contact Sales

Performancezerion.eth

$73,377.68

-1.45%· 1W

AssetsTokens

sPENDLE

StakedPendle

$24.3K

+0.72%

yb-WBTC

Yield Basis liquidity for WBTC

$11.9K

0.00%

yb-cbBTC

Yield Basis liquidity for cbBTC

$9.8K

+0.70%

ARB

Arbitrum

$4.3K

-4.25%

UNI

Uniswap

$3.8K

-2.67%

NFTsFloor

CryptoPunks V1

$4.4K

Pi Badge

$1.4K

ShizoPunks

$1.2K

The Llamas

$686.9

Anatomy of the Wallet Portfolio endpoint

Returns a wallet's portfolio overview: total value, breakdowns by position type (wallet, deposited, borrowed, locked, staked) and by chain, plus 1-day change. One call replaces a stack of RPC nodes and an indexer.

GET/v1/wallets/{address}/portfolioFull reference →

Multi-chain balancesUSD valuationsDeFi + wallet positions1d change

Request

curl "https://api.zerion.io/v1/wallets/0xabc.../portfolio" \
  -H "authorization: Basic <API_KEY>" \
  -G -d "currency=usd"

Response

{
  "data": {
    "type": "portfolio",
    "attributes": {
      "total": {
        "positions": 73928.28
      },
      "positions_distribution_by_chain": {
        "ethereum": 62495.83,
        "arbitrum": 4618.86,
        "optimism": 3223.51,
        "xdai": 2341.67
      },
      "changes": {
        "absolute_1d": 5558.77,
        "percent_1d": 8.13
      }
    }
  }
}

Key parameters

addresspathEVM or Solana wallet address to aggregate.

currencyqueryDenomination for values — usd, eur, eth, btc, and more. Defaults to usd.

filter[positions]queryonly_simple, only_complex, or no_filter to control DeFi aggregation.

What the Wallet Portfolio response gives you

One request returns enriched, ready-to-render fields — no decoding, pricing, or post-processing on your side.

Total net worth

The whole wallet as one valued number — no summing positions yourself.

total.positions

Split by chain

Exactly how value is distributed across every chain the wallet touches.

positions_distribution_by_chain

Split by type

Wallet, deposited, borrowed, locked and staked value, separated.

positions_distribution_by_type

24-hour change

Absolute and percentage movement over the last day, pre-computed.

changes.percent_1d

16 currencies

Denominate every value server-side — USD, EUR, ETH, BTC and 12 more.

currency=usd

Real-time freshness

Continuously indexed; poll until 200 and stop after ~2 minutes.

GET /portfolio

Built for production

Everything the Wallet Portfolio endpoint gives you to ship a real integration — filters, coverage, and predictable limits.

Filtering

Scope wallet vs DeFi in one param

A single flag decides whether you get simple wallet balances, DeFi protocol positions, or both — so the same endpoint powers a lightweight balance widget or a full net-worth view.

filter[positions]=only_simple — wallet positions (default)
only_complex — DeFi protocol positions only
no_filter — combined view of both

Coverage

51+ chains and Solana in one call

Aggregate an address across every supported network without a request per chain. EVM and Solana return in the same shape.

51+ EVM chains + Solana
Values already converted to your currency
Solana returns wallet positions today (protocol positions are EVM-only)

One call

Replace an indexer and a fleet of RPCs

One authenticated GET returns the aggregated portfolio Zerion computes and caches — no node infrastructure, no per-chain plumbing.

GET /v1/wallets/{address}/portfolio
HTTP Basic auth with your API key
JSON:API response, ready to render

Limits

Predictable behavior at scale

Clear status codes make the endpoint safe to poll and easy to run in production.

429 when rate-limited — back off and retry
First call may index the wallet; poll until 200
Stop retrying after ~2 minutes

What teams build with it

From dashboards to autonomous agents, teams reach for the Wallet Portfolio endpoint to ship faster.

Portfolio dashboards

Render a wallet's full net worth and per-chain breakdown without running your own indexer.

Tax & accounting

Snapshot total value and cost basis across chains for reporting and reconciliation.

AI agents

Give an agent a single, enriched view of any wallet it needs to read or act on.

Other endpoints

Portfolio Data

Track EVM & Solana tokens, NFTs, and balances across EVM & Solana & 50+ chains with a single call.

Performancezerion.eth

$73,377.68

-1.45%· 1W

AssetsTokens

sPENDLE

StakedPendle

$24.3K

+0.72%

yb-WBTC

Yield Basis liquidity for WBTC

$11.9K

0.00%

yb-cbBTC

Yield Basis liquidity for cbBTC

$9.8K

+0.70%

ARB

Arbitrum

$4.3K

-4.25%

UNI

Uniswap

$3.8K

-2.67%

NFTsFloor

CryptoPunks V1

$4.4K

Pi Badge

$1.4K

ShizoPunks

$1.2K

The Llamas

$686.9

One API, every major chain

Ethereum, Base, Solana, Arbitrum and 45+ more networks — queried in a single call.

Ethereum

Base

Solana

Arbitrum

Optimism

Ethereum

Base

Solana

Arbitrum

Optimism

Ethereum

Base

Solana

Arbitrum

Optimism

Ethereum

Base

Solana

Arbitrum

Optimism

Ethereum

Base

Solana

Arbitrum

Optimism

Ethereum

Base

Solana

Arbitrum

Optimism

Polygon

Avalanche

BNB Chain

Robinhood

Linea

Scroll

Polygon

Avalanche

BNB Chain

Robinhood

Linea

Scroll

Polygon

Avalanche

BNB Chain

Robinhood

Linea

Scroll

Polygon

Avalanche

BNB Chain

Robinhood

Linea

Scroll

Polygon

Avalanche

BNB Chain

Robinhood

Linea

Scroll

Polygon

Avalanche

BNB Chain

Robinhood

Linea

Scroll

Zora

Celo

Gnosis

Fantom

Aurora

HyperEVM

Zora

Celo

Gnosis

Fantom

Aurora

HyperEVM

Zora

Celo

Gnosis

Fantom

Aurora

HyperEVM

Zora

Celo

Gnosis

Fantom

Aurora

HyperEVM

Zora

Celo

Gnosis

Fantom

Aurora

HyperEVM

Zora

Celo

Gnosis

Fantom

Aurora

HyperEVM

Explore all chains →

Why builders choose the
Wallet Portfolio API

Ship faster

Go live in minutes, not months

Grab a free key, paste one request, and you're serving portfolio data. No nodes, no indexers, no infra to maintain.

< 5 min to first callGet a free API key

Speed

Fast everywhere your users are

A globally cached edge keeps every query fast, so your app feels instant no matter where your users open it.

~50ms median response

Freshness

Balances update in seconds

Balances, positions, and transactions land within seconds of confirmation. Never stale, never guessing.

Fresh within 1 block

Scale

Scale from one user to millions

One request spans Solana, Ethereum, Base and 50+ chains. The same endpoint carries your first user and your millionth.

50+ chains · billions of calls

Built for Consumer Scale and Enterprise Reliability

Powering applications from startups to fintech companies with infrastructure that scales seamlessly and delivers consistently.

1000+

RPS

SLA

Guaranteed

99.9%

Uptime

Stay ahead with the Zerion API

New endpoints, chains, and webhooks — straight to your inbox.

Simple, transparent tiers

Start building for free. Upgrade as you scale.

Developer

$0forever

For early prototypes and proofs of concept

Get Started Free

2K requests / day
3 RPS limit
Chat widget
Best effort support

Builder

$149/ month

For shipping MVP without running any Infrastructure

Start building

Up to 250K requests / month
10 RPS
Telegram group
Priority support

Custom pricing & features

For scale-ups & enterprises with high volume or custom needs

Contact sales

2.5M+ requests / month

1,000+ RPS

Slack or Telegram channel

24/7 support

99.9% uptime SLA

Dedicated account manager

What can you build?

Wallets & Stablecoins

Power portfolio views, transaction history, and in-app swaps with one API — across every chain and stablecoin your users hold.

Fintech & Neobanks

Add portfolio charts, PnL, and transaction history to your app — no blockchain node to stand up, no infra to maintain.

AI Agents

Wallet holdings, DeFi positions, and PnL in a single call. Pay per request with x402 on Base — no subscriptions, no keys.

Trusted by the companies you know

From multichain wallets to onchain apps — teams build on Zerion API.

“Zerion API powers Kraken 2.0 with reliable token balances, P&L, and transaction history through one consolidated integration, making it easier to scale to more users.”

Washington SanchezKraken

Read case study

“We've worked with Zerion API since day zero, even before launching Uniswap Wallet. From multichain positions to EIP-7702 batching, they've been key partners.”

Noah CitronEngineering Lead, Uniswap Wallet

Read case study