Aggregated portfolio totals (tokens, DeFi, NFTs) by network for any EVM wallet address via x402
What it does
The Zapper portfolio-totals endpoint returns aggregated portfolio value breakdowns — token balances, DeFi/app balances, and NFT balances — each with a USD total and per-network detail. You supply one or more 0x wallet addresses and optionally filter by chain IDs. The response includes `tokenBalances.totalBalanceUSD`, `appBalances.totalBalanceUSD`, and `nftBalances.totalBalanceUSD`, each with a `byNetwork` breakdown. This is part of Zapper's broader x402-gated API suite covering 60+ EVM chains.
Payment is handled via the x402 protocol on Base (chain 8453) using USDC. Each call costs 1,875 base units of USDC (6 decimals), which equals $0.001875 per request. The endpoint accepts POST requests with a JSON body. The x402 challenge was captured live and confirms the endpoint is operational.
Zapper also exposes related endpoints for granular token balances, DeFi positions, NFT balances, transaction history, token prices, search, rankings, and identity resolution — all at similar sub-cent price points. The full OpenAPI spec (v3.1.0) is available at the origin and documents input/output schemas for each tool.
Capabilities
Use cases
- —Get the total USD value of all tokens, DeFi positions, and NFTs held by a wallet
- —Compare portfolio composition across multiple EVM chains for a single address
- —Aggregate balances for a list of addresses (e.g., a fund's wallets) in one call
- —Build a portfolio dashboard that shows per-network breakdowns
- —Power an AI agent that answers 'how much is this wallet worth?'
Fit
Best for
- —Agents or apps that need a quick USD snapshot of any EVM wallet
- —Multi-chain portfolio aggregation without running your own indexer
- —Sub-cent per-call pricing for high-volume wallet lookups
Not for
- —Historical portfolio value over time (this is a point-in-time snapshot)
- —Non-EVM chains (Bitcoin, Solana, etc.)
- —Detailed per-token or per-position breakdowns (use token-balances or defi-balances endpoints instead)
Quick start
curl -X POST https://public.zapper.xyz/x402/portfolio-totals \
-H 'Content-Type: application/json' \
-H 'X-Payment: <x402-payment-token>' \
-d '{"addresses":["0xd8da6bf26964af9d7eed9e03e53415d37aa96045"]}'Example
Request
{
"chainIds": [
1,
8453
],
"addresses": [
"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
]
}Response
{
"data": {
"portfolioV2": {
"appBalances": {
"byNetwork": {},
"totalBalanceUSD": 456789.12
},
"nftBalances": {
"byNetwork": {},
"totalBalanceUSD": 78901.23
},
"tokenBalances": {
"byNetwork": {},
"totalBalanceUSD": 1234567.89
}
}
}
}Endpoint
Quality
Full OpenAPI 3.1 schema with input/output descriptions, live 402 challenge confirming the endpoint is operational, clear pricing ($0.001875/call in Base USDC). Docked slightly because no actual 200 response example was captured, and the crawled docs pages returned 404s (the legacy /api Swagger is a deprecated v2 API, not the x402 suite).
Warnings
- —The /docs and /pricing pages on the origin return 404; documentation for the x402 endpoints is only available via the OpenAPI spec and 402 challenge metadata.
- —The legacy Swagger UI at /api shows a deprecation notice pointing to build.zapper.xyz — the x402 endpoints are a separate, newer product.
- —Response example is inferred from the output schema; no actual 200 body was captured in the probe.
Citations
- —The endpoint costs 1875 base units of USDC on Base (chain 8453), equal to $0.001875 per callhttps://public.zapper.xyz/x402/portfolio-totals
- —Zapper API covers 60+ chains with tools for token prices, NFTs, portfolios, transactions, and morehttps://public.zapper.xyz/x402/portfolio-totals
- —The legacy Zapper API at /api carries a deprecation notice directing users to build.zapper.xyzhttps://public.zapper.xyz/api
- —The endpoint accepts addresses (required) and chainIds (optional) as input parametershttps://public.zapper.xyz/x402/portfolio-totals