{"uid":"cap_1MrjxBQUx4FSoYJByeMev","slug":"base-wallet-snapshot-24b83c4f","name":"Base Wallet Snapshot","description":"Read a Base wallet native ETH balance and up to five ERC20 token balances at one pinned block. Separate balance lookups each answer at whatever height they happened to see, so they cannot be compared; these are all read at the same block and the block is in the response. Replaces six calls with one.","url":"https://api.zfinia.com/x402/v1/base-wallet-snapshot?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"tokens":{"type":"array","items":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"maxItems":5,"description":"Up to five ERC20 contract addresses to read balances for."},"wallet":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Wallet address to read."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.008","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.008/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_iHji8N-sjmRzBS3JjDUG1","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.008","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Reads a Base wallet's native ETH balance and up to five ERC20 token balances atomically at the same pinned block height in a single call.","exampleAgentPrompt":"What's the current ETH balance and the USDC (0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA) and WETH (0x4200000000000000000000000000000000000006) balances for the wallet 0xAbCd1234abcd1234abcd1234abcd1234abcd1234 on Base — all at the same block so I can compare them?","exampleUseCases":[{"title":"DeFi portfolio snapshot for accounting","prompt":"Pull the ETH balance plus USDC (0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA) and DAI (0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb) balances for wallet 0xAbCd1234abcd1234abcd1234abcd1234abcd1234 on Base — I need all three pinned to the same block so I can run accurate P&L calculations."},{"title":"Agent treasury health check","prompt":"Check the ETH and token balances for our treasury wallet 0xDead0000beef0000cafe0000dead0000beef0000 on Base — include USDC at 0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA and cbETH at 0xBe9895146f7AF43049ca1c1AE358B0541Ea49704 all at the same block height so the numbers are consistent."},{"title":"Pre-trade liquidity check","prompt":"Before I execute a swap, can you snapshot wallet 0x1234abcd1234abcd1234abcd1234abcd1234abcd on Base and tell me its ETH balance alongside its WETH (0x4200000000000000000000000000000000000006) and USDC (0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA) balances, all at the same block?"}],"resultDescription":"Returns the wallet's native ETH balance, the balance of each requested ERC20 token (up to five), and the pinned block number at which all balances were read — enabling consistent cross-asset comparison in a single response.","failureModes":["Invalid wallet address format (not a valid 0x hex address) returns a validation error","ERC20 contract address that is not a valid token contract may return zero or an error","More than five ERC20 addresses in the tokens array is rejected","Network or RPC unavailability on Base may result in a timeout or 5xx error","Payment failure via x402 protocol results in 402 response before data is returned"],"whenToPreferThis":"Choose this endpoint when you need ETH and multiple ERC20 token balances for a single Base wallet at a consistent block height — replacing up to six separate RPC calls with one atomic snapshot. Ideal for DeFi agents, portfolio trackers, treasury monitors, and any workflow where cross-asset balance comparisons must be temporally consistent. Prefer this over individual balance lookups whenever block-height consistency matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T18:42:32.652Z","isFirstParty":false,"canonicalSlug":"base-wallet-snapshot-24b83c4f"}