# Base Wallet Snapshot

> Base Wallet Snapshot is a paid API for AI agents from agent-utils-x402.fishbowlinc.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-11-02).

Returns a comprehensive snapshot of any Base address including Basename, account type, transaction history, ETH balance, and balances of 31 major Base tokens with USD values and totals.

## Facts

- Endpoint: GET https://agent-utils-x402.fishbowlinc.workers.dev/v1/base-wallet?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/base-wallet-snapshot-b15cbe10
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RJQNKRVhJF9X85V2uWx9N

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-b15cbe10
```

Example prompt: Can you give me a full wallet snapshot for 0x1234567890abcdef1234567890abcdef12345678 on Base — I want to see its Basename, account type, all token balances with USD values, and a summary?

## When to prefer this

Choose this endpoint when you need a comprehensive, multi-token portfolio snapshot of any Base address in a single call rather than making individual RPC calls per token. It is ideal when you need both on-chain metadata (account type, Basename, tx count) AND token balances in one response. Prefer over raw RPC calls when you need USD values pre-calculated, or when you need the curated list of 31 major Base tokens without manually specifying each contract address.

## Known failure modes

- Invalid or malformed address format (must be 0x + 40 hex chars) returns validation error
- Address with no on-chain activity may return zero balances and minimal metadata
- RPC or node connectivity issues may cause temporary lookup failures
- Very new tokens not in the 31-token list will not appear in balances
- EIP-7702 delegation detection may lag if delegation is very recent

## How this service works

Base wallet snapshot: Basename, account type (EOA, contract, EIP-7702 delegated), tx count and activity level, ETH balance and balances of 31 major Base tokens (USDC, USDT, WETH, cbBTC, wstETH, AERO, VIRTUAL, DEGEN, BRETT...) with USD values and total, plus a one-line summary. Query: address.

## Output

Returns a structured JSON object containing: the address's Basename (if registered), account type (EOA, contract, or EIP-7702 delegated), total transaction count and activity level label, ETH balance, individual balances for 31 major Base tokens (USDC, USDT, WETH, cbBTC, wstETH, AERO, VIRTUAL, DEGEN, BRETT, and others) each with USD value, a grand total portfolio value in USD, and a concise one-line human-readable summary of the wallet.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "Any Base address"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/base-wallet-snapshot-b15cbe10/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-utils-x402.fishbowlinc.workers.dev](https://www.zero.xyz/host/agent-utils-x402.fishbowlinc.workers.dev/llms.txt)