# Base Wallet Snapshot

> Base Wallet Snapshot is a paid API for AI agents from api.zfinia.com, paid per call via x402, $0.008/call, status unknown (last checked 2026-10-10).

Reads a Base wallet's native ETH balance and up to five ERC20 token balances atomically at the same pinned block height in a single call.

## Facts

- Endpoint: POST https://api.zfinia.com/x402/v1/base-wallet-snapshot?utm_source=zero.xyz
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/base-wallet-snapshot-24b83c4f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1MrjxBQUx4FSoYJByeMev

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-snapshot-24b83c4f -d '<json body>'
```

Example prompt: What's the current ETH balance and the USDC (0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA) and WETH (0x4200000000000000000000000000000000000006) balances for the wallet 0xAbCd1234abcd1234abcd1234abcd1234abcd1234 on Base — all at the same block so I can compare them?

## When to prefer this

Choose this endpoint when you need ETH and multiple ERC20 token balances for a single Base wallet at a consistent block height — replacing up to six separate RPC calls with one atomic snapshot. Ideal for DeFi agents, portfolio trackers, treasury monitors, and any workflow where cross-asset balance comparisons must be temporally consistent. Prefer this over individual balance lookups whenever block-height consistency matters.

## Known failure modes

- Invalid wallet address format (not a valid 0x hex address) returns a validation error
- ERC20 contract address that is not a valid token contract may return zero or an error
- More than five ERC20 addresses in the tokens array is rejected
- Network or RPC unavailability on Base may result in a timeout or 5xx error
- Payment failure via x402 protocol results in 402 response before data is returned

## How this service works

Read a Base wallet native ETH balance and up to five ERC20 token balances at one pinned block. Separate balance lookups each answer at whatever height they happened to see, so they cannot be compared; these are all read at the same block and the block is in the response. Replaces six calls with one.

## Output

Returns the wallet's native ETH balance, the balance of each requested ERC20 token (up to five), and the pinned block number at which all balances were read — enabling consistent cross-asset comparison in a single response.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "tokens": {
   "type": "array",
   "items": {
    "type": "string",
    "pattern": "^0x[0-9a-fA-F]{40}$"
   },
   "maxItems": 5,
   "description": "Up to five ERC20 contract addresses to read balances for."
  },
  "wallet": {
   "type": "string",
   "pattern": "^0x[0-9a-fA-F]{40}$",
   "description": "Wallet address to read."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/base-wallet-snapshot-24b83c4f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.zfinia.com](https://www.zero.xyz/host/api.zfinia.com/llms.txt)