# Base Wallet Portfolio Balances API

> Base Wallet Portfolio Balances API is a paid API for AI agents from build-4c941cab041172e9439ece2f.emblem.build, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Fetches native ETH and major ERC-20 token balances with USD values and a total portfolio value for a given Base wallet address in a single call.

## Facts

- Endpoint: POST https://build-4c941cab041172e9439ece2f.emblem.build/pub/tasks/x402-onchain/api/portfolio
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/base-wallet-portfolio-balances-api-0185cfae
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LOblfrkh9VuJtCZxl0qJ2

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 base-wallet-portfolio-balances-api-0185cfae -d '<json body>'
```

Example prompt: Can you pull up the full portfolio for Base wallet 0x1234...abcd — I want to see the native ETH balance, all major ERC-20 tokens, their USD values, and the total portfolio worth?

## When to prefer this

Choose this endpoint when you need a one-shot aggregated view of a wallet's native ETH and major ERC-20 holdings with USD valuations on the Base network, rather than querying individual token contracts or price feeds separately. Ideal for portfolio dashboards, pre-trade checks, or agent-driven net worth calculations on Base.

## Known failure modes

- Invalid or malformed wallet address returns an error
- Unrecognized or non-Base address may return empty balances
- Network or RPC timeout may cause a temporary failure
- Payment not processed (x402 USDC payment failure) results in 402 error
- Token price data unavailable may cause missing USD values for some assets

## How this service works

Base wallet portfolio in one call: native + major ERC-20 balances with USD values and total. Onchain USDC pay-per-call.

## Output

Returns a breakdown of the wallet's native ETH balance and balances of major ERC-20 tokens on Base, each with their current USD price and value, plus a grand total portfolio value in USD — all in a single structured response.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/base-wallet-portfolio-balances-api-0185cfae/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from build-4c941cab041172e9439ece2f.emblem.build](https://www.zero.xyz/host/build-4c941cab041172e9439ece2f.emblem.build/llms.txt)