{"uid":"cap_bS8wy8x_1n4IRLHUcHSQ5","slug":"evm-wallet-balance-lookup-api-3e5f9940","name":"EVM Wallet Balance Lookup API","description":"Evidence-backed npm package upgrade decisions for coding agents.","url":"https://x402-safe-upgrade-api.onrender.com/v1/wallet-balance?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"chain":{"enum":["base","base-sepolia"],"type":"string"},"address":{"type":"string","description":"Public 0x-prefixed EVM address."},"tokenAddress":{"type":"string","description":"Optional public ERC-20 contract address."}}},"responseSchema":{"type":"json","example":{"token":{"address":"0x...","balanceRaw":"0"},"nativeBalanceWei":"0"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Ofpr2UXgqULIs5h2NxB-3","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves native and ERC-20 token balances for a given EVM wallet address on Base or Base Sepolia networks.","exampleAgentPrompt":"What's the current native ETH balance and USDC token balance (contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48) for the wallet 0x1234...abcd on the Base mainnet?","exampleUseCases":[{"title":"DeFi agent pre-trade balance check","prompt":"Before executing this swap, check how much ETH and USDC the wallet 0xAbCd...1234 holds on Base mainnet so I know if there's enough to cover the trade."},{"title":"Testnet funding verification","prompt":"Can you confirm that my testnet wallet 0xDead...Beef on Base Sepolia has received funds? Show me the native balance in Wei."},{"title":"Portfolio dashboard balance sync","prompt":"Pull the current raw token balance for ERC-20 contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base for wallet address 0x9F8F...3321 so I can update my portfolio tracker."}],"resultDescription":"Returns a JSON object containing the wallet's native balance in Wei and, if a token contract address was provided, the ERC-20 token's raw balance and contract address.","failureModes":["Invalid or malformed 0x address returns an error","Unsupported chain value (not 'base' or 'base-sepolia') causes rejection","Invalid ERC-20 contract address returns token balance as zero or error","Network connectivity issues with the Base RPC may cause timeouts","Payment failure (402) if USDC payment is not correctly attached"],"whenToPreferThis":"Use this endpoint when you need a quick, paid on-demand balance lookup for a wallet on Base mainnet or Base Sepolia testnet, especially in agentic workflows where trustless, evidence-backed financial state verification is needed before executing transactions or making decisions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T06:39:57.008Z","isFirstParty":false,"canonicalSlug":"evm-wallet-balance-lookup-api-3e5f9940"}