# 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.15/call, status unknown (last checked 2026-10-17).

Batch read-only EVM state queries (wallet balances, token balances, 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/100?utm_source=zero.xyz
- Price: $0.15/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-b58dbd90
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_37_B49hP1qPDp0XHyShOT

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-b58dbd90 -d '<json body>'
```

Example prompt: Snapshot the current wallet state for address 0xAbC...123 across Ethereum, Base, Arbitrum, Optimism, and Polygon — I need the ETH balance, USDC token balance, and current block numbers on each chain all in one batch call.

## When to prefer this

Choose this endpoint when you need to read EVM state across multiple chains simultaneously and want to avoid making separate JSON-RPC calls to each network. Ideal for wallet dashboards, DeFi portfolio trackers, cross-chain allowance audits, and any agent workflow that needs a consistent multi-chain snapshot at a known block height. Prefer it over individual per-chain RPC calls when atomicity of snapshot timing and a single payment flow matter. The recovery URL also makes it suitable for async workflows where results need to be retrieved later.

## Known failure modes

- Invalid or malformed wallet address returns an error result for that query item
- Unsupported chain identifier causes that specific sub-query to fail while others may succeed
- Payment not fulfilled (x402) results in 402 Payment Required before any state is read
- Rate limiting or overloaded RPC nodes may cause stale or delayed block data
- Expired results: the expiresAt field indicates when cached results are no longer valid
- Network-level timeout on a specific chain may return partial results

## 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

Returns a JSON object containing an array of results, each with a query ID, type (e.g. block_number, token balance), chain name, and value. Also includes an expiry timestamp, a unique requestId, a recovery URL for retrieving results later, a verification note, and a snapshotBlocks map showing the block number at which each chain was queried.

## 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-b58dbd90/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)