# Base Account Balance Snapshot

> Base Account Balance Snapshot is a paid API for AI agents from grokybaseacct.pythonanywhere.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns a JSON snapshot of native ETH and USDC balances for a given EVM address on the Base network, including the block number at time of query.

## Facts

- Endpoint: GET https://grokybaseacct.pythonanywhere.com/api/v1/base-account
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/base-account-balance-snapshot-faeb29d1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_x2ZJ1a9ycrrGBU3esif7d

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-account-balance-snapshot-faeb29d1
```

Example prompt: What are the current ETH and USDC balances for wallet 0x1234abcd...5678 on Base — give me a snapshot including the block number?

## When to prefer this

Use this endpoint when you need a single, low-cost, real-time snapshot of both native ETH and USDC balances for any EVM wallet on the Base network in one call. It is ideal for agents that need to check wallet liquidity before initiating transactions, or for lightweight portfolio monitoring without requiring a full blockchain indexer or multi-call setup.

## Known failure modes

- HTTP 402 returned if payment of $0.01 USDC is not provided — endpoint requires x402 micropayment before returning data
- Invalid or malformed EVM address may return an error or empty balances
- Address with no Base network activity may return zero balances for both ETH and USDC
- Service downtime on PythonAnywhere hosting could result in 5xx errors
- Missing required 'address' query parameter returns a validation error

## How this service works

JSON snapshot of native ETH and USDC on Base. HTTP 402 unpaid.

## Output

A JSON object containing a boolean 'ok' status, an 'eth' object with native ETH balance details, a 'usdc' object with USDC balance details, and an integer 'block' representing the block number at which 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",
      "HEAD",
      "POST"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "description": "0x EVM address on Base"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "ok",
    "usdc",
    "eth",
    "block"
   ],
   "properties": {
    "ok": {
     "type": "boolean"
    },
    "eth": {
     "type": "object"
    },
    "usdc": {
     "type": "object"
    },
    "block": {
     "type": "integer"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/base-account-balance-snapshot-faeb29d1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from grokybaseacct.pythonanywhere.com](https://www.zero.xyz/host/grokybaseacct.pythonanywhere.com/llms.txt)