# EVM State Batch — Multi-Chain Wallet Snapshot

> EVM State Batch — Multi-Chain Wallet Snapshot is a paid API for AI agents from evmstate.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-17).

Batch read-only EVM state queries (wallet balances, token holdings, allowances, contract data, block numbers) across Ethereum, Base, Arbitrum, Optimism, and Polygon in a single call.

## Facts

- Endpoint: POST https://evmstate.com/v1/state-batch?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/evm-state-batch-multi-chain-wallet-snapshot-21b68b18
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FddeEIslbDLa4KTqT-THk

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 evm-state-batch-multi-chain-wallet-snapshot-21b68b18 -d '<json body>'
```

Example prompt: Pull a snapshot of wallet 0xAbC...123's ETH balance, USDC token balance, and Uniswap router allowance on Base, Arbitrum, and Ethereum all at once — I need the current block numbers for each chain too.

## When to prefer this

Choose this endpoint when you need to read multiple pieces of on-chain state (balances, allowances, contract calls, block numbers) across several EVM chains in a single atomic snapshot. It is ideal for DeFi portfolio auditing, pre-transaction checks, and multi-chain allowance reviews where latency and atomicity matter. Prefer it over individual chain-specific RPC calls when you need data from 2+ chains simultaneously or want to avoid managing multiple RPC connections.

## Known failure modes

- Invalid or malformed wallet/contract address returns an error result for that item
- Unsupported chain identifier causes that batch item to fail
- Network congestion or RPC timeout may cause partial results or full failure
- Payment not received or insufficient USDC causes 402 response before any data is returned
- Expired results — after the expiresAt timestamp the recovery URL may no longer return data

## How this service works

Batch read-only wallet, token, allowance, contract, and block checks across Ethereum, Base, Arbitrum, Optimism, and Polygon. Fixed Base USDC prices from $0.05.

## Output

A JSON array of results, one per requested check, each tagged with an ID, type (e.g. block_number, token_balance, allowance), chain name, and value. Also returns an expiry timestamp (ISO 8601), a unique request ID, a recovery URL to re-fetch results, a verification note, and a map of snapshot block numbers per chain.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "results": [
   {
    "id": "ethereum-native-balance",
    "type": "native_balance",
    "chain": "ethereum",
    "value": "0x0",
    "blockNumber": "0x18e456e"
   },
   {
    "id": "base-native-balance",
    "type": "native_balance",
    "chain": "base",
    "value": "0x0",
    "blockNumber": "0x31a5006"
   },
   {
    "id": "arbitrum-native-balance",
    "type": "native_balance",
    "chain": "arbitrum",
    "value": "0x0",
    "blockNumber": "0x1e729abb"
   },
   {
    "id": "optimism-native-balance",
    "type": "native_balance",
    "chain": "optimism",
    "value": "0x0",
    "blockNumber": "0x965919b"
   },
   {
    "id": "polygon-native-balance",
    "type": "native_balance",
    "chain": "polygon",
    "value": "0x0",
    "blockNumber": "0x5a67efe"
   }
  ],
  "expiresAt": "2026-11-01T00:00:00.000Z",
  "requestId": "12345678-1234-4234-9234-123456789abc",
  "recoveryUrl": "https://evmstate.com/v1/results/12345678-1234-4234-9234-123456789abc",
  "verification": "each result is a successful JSON-RPC response",
  "snapshotBlocks": {
   "base": "0x31a5006",
   "polygon": "0x5a67efe",
   "arbitrum": "0x1e729abb",
   "ethereum": "0x18e456e",
   "optimism": "0x965919b"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/evm-state-batch-multi-chain-wallet-snapshot-21b68b18/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from evmstate.com](https://www.zero.xyz/host/evmstate.com/llms.txt)