# Base Wallet Snapshot

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

Returns a real-time snapshot of a Base chain wallet or contract address, including native ETH balance, ERC-20 token balances, USD valuations, nonce, and contract metadata.

## Facts

- Endpoint: GET https://api.arysphere.com/v1/ventures/x402_chain_reads_v1/base_wallet_snapshot?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-22
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/base-wallet-snapshot-a4ee178e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_miFUCIVICtjrQurjjba2U

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

Example prompt: What's the full on-chain snapshot for Base address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 — give me the ETH balance, any USDC or WETH it holds, the total USD value, and whether it's a contract?

## When to prefer this

Use this endpoint when you need a fast, no-auth, pay-per-call on-chain snapshot of a Base wallet or contract — specifically for ETH balance, USDC/WETH token balances, USD valuation via Chainlink, nonce, and contract detection — without needing to set up an RPC node, API key, or account. Prefer this over raw RPC calls when you want aggregated USD pricing alongside balances in a single call, and over general Ethereum endpoints when you specifically need Base chain data.

## Known failure modes

- Invalid address format (not 0x + 40 hex) returns a validation error
- Address with no recognized token holdings returns an empty tokens array with usd_total_complete: false
- Chainlink oracle unavailable may cause missing USD valuations
- Payment failure via x402 prevents the call from being served
- RPC node timeout or Base chain congestion may delay or fail the response

## How this service works

Check this wallet: Base ETH and top-10 token balances, nonce, contract flag, USD totals.  Returns: a wallet snapshot on Base: the native ETH balance, nonce, whether the address is a contract, and its balances of ten major Base tokens (WETH, USDC, USDbC, DAI, cbETH, wstETH, cbBTC, AERO, VIRTUAL, DEGEN), with USD for ETH, WETH and dollar stablecoins. One batched read, cached 60 seconds; no other tokens, no labels.

## Output

A JSON object containing the wallet's native ETH balance (amount and USD value), a list of recognized ERC-20 token balances (WETH, USDC) with USD valuations sourced from Chainlink, the total USD value across priced assets, the address nonce, whether the address is a contract (code_bytes), the ETH/USD price and its oracle source, the age of the data in seconds, and the number of RPC calls made.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "address": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "wallet or contract, 0x + 40 hex"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "chain": "base",
  "cached": false,
  "method": "snapshot",
  "result": {
   "chain": "base",
   "nonce": 70,
   "native": {
    "usd": 7604.48,
    "amount": "3.12882180347273728",
    "symbol": "ETH"
   },
   "tokens": [
    {
     "usd": 540.81,
     "token": "0x4200000000000000000000000000000000000006",
     "amount": "0.222512739074208417",
     "symbol": "WETH",
     "usd_basis": "chainlink ETH/USD"
    },
    {
     "usd": 45.15,
     "token": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
     "amount": "45.145979",
     "symbol": "USDC",
     "usd_basis": "dollar stablecoin"
    }
   ],
   "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
   "eth_usd": 2430.46003758,
   "age_secs": 0,
   "rpc_calls": 3,
   "code_bytes": 23,
   "is_contract": true,
   "eth_usd_source": "chainlink ETH/USD 0x71041dddad3595f9ced3dccfbe3d1f4b0a16bb70",
   "tokens_checked": [
    "WETH",
    "USDC"
   ],
   "usd_total_priced": 8199.06,
   "usd_total_complete": false
  },
  "service": "x402_chain_reads_v1.base_wallet_snapshot"
 }
}
```

## More

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