# Zapper Portfolio Totals

> Zapper Portfolio Totals is a paid API for AI agents from public.zapper.xyz, paid per call via x402, $0.001875/call, status down (last checked 2026-09-16, last successful call 2026-06-05).

Returns aggregated portfolio value totals (tokens, apps, NFTs) broken down by network for one or more wallet addresses.

## Facts

- Endpoint: POST https://public.zapper.xyz/x402/portfolio-totals
- Price: $0.001875/call
- Payment: x402
- Status: down
- Last checked: 2026-09-16
- Last successful call: 2026-06-05
- Success rate: 100% of calls made through Zero
- Activations on Zero: 2
- Tags: x402
- Canonical page: https://www.zero.xyz/c/public-zapper-xyz-ba719ddf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jVkvzl3Dz0z1By_ssg08f

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability public-zapper-xyz-ba719ddf -d '<json body>'
```

Example prompt: What's the total portfolio value of 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 broken down by network? Show me Ethereum and Base only.

## When to prefer this

Use this endpoint when you need a high-level portfolio summary with USD totals grouped by blockchain network, rather than a detailed token-by-token breakdown. Ideal for dashboards, net worth calculations, or comparing cross-chain exposure. Prefer this over the detailed token balances endpoint when you only need aggregate figures, not individual token line items.

## Known failure modes

- Missing or empty addresses array returns a validation error
- Invalid wallet address format (non-0x) may return an error or empty results
- Unsupported or invalid chain IDs in chainIds array may be silently ignored or cause errors
- Rate limiting or payment failure returns a 402 or 429 error
- Network timeouts for addresses with very large portfolios

## How this service works

Enterprise grade onchain data across 60+ chains - token prices, NFTs, portfolios, onchain search, Farcaster and more.

## Output

A JSON object containing total USD balance across all tokens, apps, and NFTs, plus a per-network breakdown showing each network's name, slug, chainId, and USD balance contribution. The example shows Ethereum (~$872k), Base (~$48k), BNB Chain (~$9k), and Optimism among others for a total of ~$937k.

## Example request

```json
{
 "chainIds": [
  1,
  8453
 ],
 "addresses": [
  "0x1234567890123456789012345678901234567890"
 ]
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chainIds": {
   "type": "array",
   "items": {
    "type": "integer"
   },
   "description": "Optional list of Chain IDs to filter by (e.g. [1, 8453])"
  },
  "addresses": {
   "type": "array",
   "items": {
    "type": "string",
    "description": "A 0x wallet address"
   },
   "description": "Array of 0x wallet addresses to aggregate"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/public-zapper-xyz-ba719ddf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from public.zapper.xyz](https://www.zero.xyz/host/public.zapper.xyz/llms.txt)