# Agent EVM State Batch

POST https://evmstate.com/v1/state-batch
Payment: x402 exact USDC on Base. Tiers: POST /v1/state-batch (up to 25 checks, $0.05), POST /v1/state-batch/50 (up to 50, $0.10), POST /v1/state-batch/100 (up to 100, $0.15).
Input: JSON object with requestId (unique random ID) and checks[], within the selected route's limit, each with unique id, chain, and type. A larger batch is one payment and one snapshot per chain, not separate paid requests. After successful payment, recover the exact result at /v1/results/{requestId} for 30 days. Unpaid results are never returned.
Supported types: native_balance, erc20_balance, allowance, contract_code, block_number, eth_call.
Supported chains: ethereum, base, arbitrum, optimism, polygon.
All operations are read-only. Each chain is pinned to one block per batch. Results are RPC-provider responses, not cryptographic state proofs. Do not send transaction methods or secrets.
After settlement, recover at https://evmstate.com/v1/results/{requestId} for 30 days. The requestId is a bearer recovery key; keep it private.
See /openapi.json for schemas and examples.