{"uid":"cap_3NtNpSR3Fdg8GCTQTLmEN","slug":"base-erc20-balance-d7d79993","name":"base-erc20-balance","description":"ERC20 token balance for a wallet on Base mainnet - balanceOf() and decimals() batched into one Multicall3 round trip.","url":"https://x402.agentindex.world/base/erc20-balance?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"token":{"type":"string","title":"Token"},"wallet":{"type":"string","title":"Wallet"}}},"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_AUMkgBoNl5HMBULe6L_Fu","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":"Fetches the human-readable ERC20 token balance for a given wallet address on Base mainnet using a single Multicall3 round trip (batching balanceOf and decimals calls).","exampleAgentPrompt":"What's the USDC balance for wallet 0xAbC...123 on Base mainnet? The token contract is 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913.","exampleUseCases":[{"title":"DeFi portfolio snapshot","prompt":"Check how much USDC the wallet 0xAbC123...def holds on Base — use the USDC contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 so I can see their actual balance."},{"title":"Pre-payment eligibility check","prompt":"Before we proceed, can you confirm that wallet 0xUser...789 has at least some WETH on Base? The WETH contract there is 0x4200000000000000000000000000000000000006."},{"title":"On-chain balance audit","prompt":"I need to audit the token holdings of 0xTreasury...456 on Base mainnet — look up their balance for the governance token at contract address 0xGov...abc."}],"resultDescription":"Returns the ERC20 token balance for the specified wallet, adjusted for the token's decimals, so the agent receives a human-readable numeric balance (e.g. 145.23 USDC) along with raw balance and decimals data from a single Multicall3 batch call on Base mainnet.","failureModes":["Invalid or malformed token contract address returns an error or zero balance","Invalid or malformed wallet address returns an error","Token contract does not exist on Base mainnet — call fails or returns empty","RPC/Multicall3 timeout or Base network congestion causes request failure","Non-ERC20 contract address provided causes ABI decoding failure"],"whenToPreferThis":"Use this endpoint when you need the ERC20 token balance for a specific wallet on Base mainnet specifically, and want a single efficient call that handles both balanceOf and decimals in one round trip. Prefer this over generic RPC calls or multi-step on-chain queries when operating on Base L2 and needing a human-readable result quickly.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T06:44:32.101Z","isFirstParty":false,"canonicalSlug":"base-erc20-balance-d7d79993"}