{"uid":"cap_lxbU-0h-kefyvBP1geA8n","slug":"call402-com-base-wallet-lookup-0762d73a","name":"call402.com Base Wallet Lookup","description":"Look up a Base wallet address: native ETH plus balances for a curated list of 195 tokens, read directly from Base chain state via public RPC with a self-hosted reader (no third-party data API). The response includes a coverage field: tokens outside the list with no transfers in the discovery window (default about 28 hours) are not reported. Balances only; no USD valuation.","url":"https://call402.com/api/wallet-lookup?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"window":{"type":"integer","description":"Optional discovery window in blocks, 1000-200000 (default 50000, about 28 hours)"},"address":{"type":"string","description":"Base wallet address, required (0x + 40 hex chars)"}}},"responseSchema":{"type":"json","schema":{"type":"object","required":["address","block_number","native","tokens","coverage","elapsed_ms"],"properties":{"native":{"type":"object","required":["symbol","decimals","balance_raw","balance"],"properties":{"symbol":{"type":"string","const":"ETH"},"balance":{"type":"string"},"decimals":{"type":"integer","const":18},"balance_raw":{"type":"string"}}},"tokens":{"type":"array","items":{"type":"object","required":["address","symbol","decimals","balance_raw","balance","source"],"properties":{"source":{"enum":["list","discovery"],"type":"string"},"symbol":{"type":"string"},"address":{"type":"string"},"balance":{"type":"string"},"decimals":{"type":"integer"},"balance_raw":{"type":"string"}}}},"address":{"type":"string"},"coverage":{"type":"object","required":["token_list_size","checked","discovery_window_blocks","discovery_from_block","discovery_to_block","discovery_watchlist_size","discovery_contracts_scanned","discovery_batches_failed","discovered_off_list","discovered_with_balance","multicall3","notes"],"properties":{"notes":{"type":"array","items":{"type":"string"}},"checked":{"type":"integer"},"multicall3":{"type":"string"},"token_list_size":{"type":"integer"},"discovery_to_block":{"type":"integer"},"discovered_off_list":{"type":"integer"},"discovery_from_block":{"type":"integer"},"discovered_with_balance":{"type":"integer"},"discovery_window_blocks":{"type":"integer"},"discovery_batches_failed":{"type":"integer"},"discovery_watchlist_size":{"type":"integer"},"discovery_contracts_scanned":{"type":"integer"}}},"elapsed_ms":{"type":"integer"},"block_number":{"type":"integer"}}},"example":{"native":{"symbol":"ETH","balance":"0.004946486470660966","decimals":18,"balance_raw":"4946486470660966"},"tokens":[],"address":"0x2e34a510c818f18dc5385e950e84e69f36704dd2","coverage":{"checked":195,"token_list_size":195,"discovery_batches_failed":0,"discovery_watchlist_size":80,"discovery_contracts_scanned":160},"elapsed_ms":3182,"block_number":53281603}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_BxpSbQtIm4DPKLuFHUNbM","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up native ETH and token balances for a Base wallet address by reading directly from Base chain state via public RPC, covering 195 curated tokens plus transfer-discovered tokens within a configurable block window.","exampleAgentPrompt":"What tokens and ETH does wallet 0x742d35Cc6634C0532925a3b844Bc454e4438f44e hold on Base right now — scan the last 50000 blocks for any transfers?","exampleUseCases":[{"title":"DeFi portfolio snapshot for a Base address","prompt":"Can you pull all the token balances for 0x4a83E51047D4A71D08cA77Fd4e1A4fA13EF0e79c on Base? I want to see both the ETH and any ERC-20 tokens it holds."},{"title":"Verify incoming payment landed on Base","prompt":"Did the USDC transfer arrive? Check the current USDC and ETH balance for Base address 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BA and tell me what it shows."},{"title":"Audit an agent wallet before executing a transaction","prompt":"Before my agent tries to pay, check what ETH and token balances are available in Base wallet 0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAf — look back over the last 100000 blocks to make sure nothing recent is missed."}],"resultDescription":"Returns native ETH balance and balances for up to 195 curated ERC-20 tokens plus any additional tokens discovered via transfer events in the specified block window. Also includes a coverage field indicating which tokens fall outside the curated list and the discovery window. No USD valuations are provided — raw on-chain token amounts only.","failureModes":["Invalid or malformed wallet address (not 0x + 40 hex chars) returns an error","Window parameter outside 1000–200000 range is rejected","Tokens outside the curated 195-token list with no transfers in the discovery window are silently omitted (coverage gap)","RPC node unavailability may cause lookup failures or stale data","Very new tokens not yet in the curated list and with no transfer history in the window will not appear in results"],"whenToPreferThis":"Choose this endpoint when you need on-chain Base wallet balances read directly from chain state without relying on a centralized data API or indexer. It is ideal for agents operating in trust-minimized or DeFi contexts where self-hosted RPC reads are preferred over third-party enrichment APIs. It covers 195 curated tokens plus transfer-discovered tokens, so it works well for most common Base assets. Prefer alternatives if you need USD valuations, multi-chain support, or coverage of highly obscure tokens with no recent transfer history.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-20T00:04:04.258Z","isFirstParty":false,"canonicalSlug":"call402-com-base-wallet-lookup-0762d73a"}