{"uid":"cap_crZmf9dtgd4cahEt3dZqI","slug":"kair-os-trade-base-wallet-snapshot-133e7b4a","name":"kair-os.trade Base Wallet Snapshot","description":"Read ETH and caller-selected ERC-20 balances for a Base address at one finalized block. Exact integer amounts, optional contract-reported metadata, explicit per-token errors. No token discovery or price estimates.","url":"https://kair-os.trade/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":20,"minItems":1,"description":"1–20 unique nonzero ERC-20 contract addresses; duplicate comparison is case-insensitive.","uniqueItems":true},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Nonzero Base wallet address."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_KEmGD-YR-SBdXyLN3kYe5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns exact integer ETH and ERC-20 token balances for a specified Base address at one finalized block, with optional token metadata and per-token error reporting.","exampleAgentPrompt":"Check the exact ETH balance and balances for USDC (0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48) and WETH (0x4200000000000000000000000000000000000006) held by Base address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 at the latest finalized block.","exampleUseCases":[{"title":"DeFi portfolio position audit","prompt":"Snapshot the ETH and ERC-20 balances for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Base — I need exact integer amounts for USDC at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 and WETH at 0x4200000000000000000000000000000000000006."},{"title":"Smart contract balance verification","prompt":"What are the exact token balances held by the contract at 0x3fC91A3afd70395Cd496C647d5a6CC9D4B2b7FAD on Base for these two ERC-20s: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 and 0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb?"},{"title":"Pre-trade wallet state snapshot","prompt":"Before I execute a swap, grab the current finalized-block ETH and token balances for my Base wallet 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B across these tokens: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, 0x4200000000000000000000000000000000000006, and 0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb."}],"resultDescription":"Returns exact integer ETH balance and per-token integer balances for each requested ERC-20 contract address at a single finalized Base block. Also includes optional contract-reported token metadata (name, symbol, decimals) and explicit error entries for any tokens that could not be queried. No token discovery, price estimates, or USD values are included.","failureModes":["Invalid or zero Base wallet address returns a validation error","Invalid ERC-20 contract addresses (not matching 0x hex pattern) are rejected","More than 20 token addresses in a single request returns a validation error","Non-ERC-20 contract addresses produce per-token errors rather than balances","RPC or node unavailability may cause the entire request to fail","Duplicate token addresses (case-insensitive) may be deduplicated or rejected"],"whenToPreferThis":"Choose this endpoint when you need precise, raw integer token balances for a known set of ERC-20 contracts on Base at a finalized block, without needing token discovery or price data. It is ideal for auditing specific positions, verifying holdings before a trade, or recording a historical snapshot. Prefer alternatives if you need price estimates, token discovery across an unknown portfolio, or multi-chain support.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:32:47.717Z","isFirstParty":false,"canonicalSlug":"kair-os-trade-base-wallet-snapshot-133e7b4a"}