# Base Wallet Snapshot

> Base Wallet Snapshot is a paid API for AI agents from fortune-play.onrender.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-20).

Returns ETH balance, USDC balance, ERC-20 token count, and top token holdings for any Base network wallet address.

## Facts

- Endpoint: GET https://fortune-play.onrender.com/api/base-wallet-snapshot?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/base-wallet-snapshot-a8473218
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zGUkULGCmp6chxJ8hxSzC

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

Example prompt: Can you pull a balance snapshot for the Base wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 — I need to see its ETH balance, USDC balance, and what ERC-20 tokens it holds?

## When to prefer this

Choose this endpoint when you need a quick, structured balance snapshot of a Base/EVM wallet — specifically ETH, USDC, and ERC-20 token holdings — without running your own RPC node or indexer. It is ideal for agents that need wallet intelligence as part of DeFi workflows, payment verification, treasury monitoring, or counterparty due diligence on the Base network. Prefer it over generic blockchain explorers when you need machine-readable JSON output directly consumable by an agent at minimal cost ($0.001 per call via x402 USDC).

## Known failure modes

- Invalid or malformed wallet address (not matching 0x + 40 hex chars) returns a validation error
- Address with zero activity may return empty token arrays and zero balances (valid but minimal response)
- Render.com cold start delays may cause slow first response after idle period
- Network or RPC errors fetching on-chain data may result in partial or failed snapshots
- Payment failure (insufficient USDC or x402 protocol error) prevents the call from completing

## How this service works

Pay-per-call B2B sales lead and procurement intelligence plus Base wallet data for agents. Search EU tenders/RFPs or inspect a Base wallet. Payments use x402 USDC on Base.

## Output

Returns a JSON object containing the wallet address, chain identifier ('base'), native ETH balance with symbol, USDC balance, a list of top ERC-20 token holdings (each with metadata), total ERC-20 token count, the product name, and a generated_at timestamp marking when the snapshot was taken.

## 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[a-fA-F0-9]{40}$",
       "description": "Base/EVM wallet address"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "usdc": {
       "type": "object"
      },
      "chain": {
       "type": "string"
      },
      "native": {
       "type": "object"
      },
      "address": {
       "type": "string"
      },
      "product": {
       "type": "string"
      },
      "top_tokens": {
       "type": "array",
       "items": {
        "type": "object"
       }
      },
      "erc20_count": {
       "type": "integer"
      },
      "generated_at": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "usdc": {
   "balance": "0"
  },
  "chain": "base",
  "native": {
   "symbol": "ETH",
   "balance": "1.0"
  },
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "product": "Base Wallet Snapshot",
  "top_tokens": [],
  "erc20_count": 0
 }
}
```

## More

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