# MACH Base Wallet Snapshot

> MACH Base Wallet Snapshot is a paid API for AI agents from api.mach.gallery, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-02).

Returns a point-in-time snapshot of a Base wallet's native ETH balance and ERC-20 token balances for specified token contracts.

## Facts

- Endpoint: POST https://api.mach.gallery/api/base/wallet-snapshot?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/mach-base-wallet-snapshot-e09bdf67
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0nxaIhQTWYzSp18xWyf82

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 mach-base-wallet-snapshot-e09bdf67 -d '<json body>'
```

Example prompt: What's the current ETH balance and USDC token balance for the Base wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045? Also check its balance of token contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913.

## When to prefer this

Choose this endpoint when an AI agent needs a fast, pay-per-call (no subscription or API key) balance lookup for a specific wallet on Base mainnet, especially in autonomous or on-chain workflows where cost predictability ($0.005 USDC flat) and permissionless access matter. Prefer over Etherscan or Alchemy when you want micropayment-native access without managing API keys.

## Known failure modes

- Invalid or malformed wallet address (non-0x or wrong length) returns a validation error
- Token contract addresses that are not valid ERC-20 contracts on Base may return zero balances
- Exceeding 10 token addresses in the tokens array returns a schema validation error
- Payment failure via x402 protocol prevents the call from completing
- Network congestion or RPC unavailability on Base may cause timeouts

## How this service works

Fast, low-cost Base data for autonomous agents. No API keys, no subscriptions; pay per call with USDC over x402.

## Output

A JSON object containing the wallet's native ETH balance in wei (native_wei), a list of token balances for each requested ERC-20 contract address (tokens array), and the network identifier (network: 'eip155:8453' for Base mainnet).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "tokens": {
   "type": "array",
   "items": {
    "type": "string",
    "pattern": "^0x[0-9a-fA-F]{40}$",
    "description": "ERC-20 or token contract address on Base mainnet."
   },
   "maxItems": 10,
   "description": "Up to ten token contract addresses whose balances should be included."
  },
  "address": {
   "type": "string",
   "pattern": "^0x[0-9a-fA-F]{40}$",
   "description": "Wallet or account address on Base mainnet."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tokens": [],
  "network": "eip155:8453",
  "native_wei": "0"
 }
}
```

## More

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