{"uid":"cap_PgLsf_z1DCHTVGAQ6ZhED","slug":"base-mainnet-wallet-balance-checker-2ed76e1b","name":"Base Mainnet Wallet Balance Checker","description":"Pay-per-call data for AI agents, paid in USDC on Base with x402: token risk checks (rug check) on Base, Ethereum, Arbitrum, Optimism, Polygon and Solana, onchain reads (balances, transactions, gas, contracts, NFTs, whale trades, new pools, ENS and Basenames), ECB exchange rates, and Canadian sales tax and business days.","url":"https://ca-tax-api-mainnet.lxtap.workers.dev/base/balances?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"tokens":{"type":"string","pattern":"^(0x[0-9a-fA-F]{40})(,0x[0-9a-fA-F]{40}){0,19}$","description":"Comma-separated ERC-20 contract addresses on Base, up to 20"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Wallet address on Base"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"chain":"base","tokens":[{"raw":"3528717773","token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","balance":"3528.717773","decimals":6},{"raw":"886309838294787826109722","token":"0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed","symbol":"DEGEN","balance":"886309.838294787826109722","decimals":18}],"address":"0x2211d1D0020DAEA8039E46Cf1367962070d77DA9","nativeSymbol":"ETH","nativeBalance":"7.554675633166555733"}},"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_2w8ZOYgHBJhGi8iQ_65_i","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":"Returns the native ETH balance and up to 20 ERC-20 token balances for a given wallet address on Base mainnet, formatted with each token's symbol and decimals.","exampleAgentPrompt":"What's the ETH balance and USDC balance for wallet 0xAbC...123 on Base mainnet? Also check 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 as a token address.","exampleUseCases":[{"title":"Portfolio snapshot before DeFi transaction","prompt":"Before I do anything, check the ETH balance and USDC balance for my wallet 0xAbC123...def on Base — include token contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 for USDC so I know if I have enough to proceed."},{"title":"Multi-token wallet audit for tax reporting","prompt":"Pull up the current balances for wallet 0xDeF456...abc on Base mainnet for these three tokens: 0xToken1, 0xToken2, 0xToken3 — I need the exact amounts formatted with their decimals for my records."},{"title":"Monitor whale wallet holdings on Base","prompt":"Check what ETH and token balances this whale wallet 0x789...fed holds on Base right now — include WETH at 0x4200000000000000000000000000000000000006 and DAI at 0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb."}],"resultDescription":"A structured response containing the wallet's native ETH balance and, for each requested ERC-20 contract address, the token balance formatted with the correct decimal precision alongside the token symbol — all read live from Base mainnet.","failureModes":["Invalid or malformed wallet address (not matching 0x + 40 hex chars) returns an error","More than 20 token contract addresses provided returns a validation error","Invalid ERC-20 contract address (non-contract or wrong chain) may return zero balance or error","Network or RPC issues on Base mainnet may cause timeouts","Missing required 'address' query parameter returns a 400-level error"],"whenToPreferThis":"Use this endpoint when you need live, formatted ETH and ERC-20 token balances specifically on Base mainnet, supporting up to 20 tokens in a single call with human-readable symbols and decimals. Prefer it over generic RPC calls when you want pre-formatted balances rather than raw hex values, and when you need multi-token portfolio data in one request. For OP Mainnet balances, use the sibling endpoint. For Arbitrum or Polygon, use their respective endpoints.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T12:45:07.162Z","isFirstParty":false,"canonicalSlug":"base-mainnet-wallet-balance-checker-2ed76e1b"}