{"uid":"cap_dm65PwGYKuUnVfANG9q3S","slug":"agentfeed-erc20-eth-wallet-balance-base-ethereum-1f4b2752","name":"AgentFeed ERC20 & ETH Wallet Balance (Base / Ethereum)","description":"ERC20 and native ETH wallet balance on Base or Ethereum mainnet, for a 0x address or an ENS name. decimals() and symbol() are read from the contract at request time rather than assumed, because assuming 18 reports a USDC balance a trillion times too large. Use when you need to answer: What does this EVM address hold? ENS is resolved through two independent resolvers and the answer is used only…","url":"https://x402.ochinimus.app/api/base-balance?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":{"chain":{"type":"string","description":"base (default) or ethereum"},"token":{"type":"string","description":"ERC20 contract address, or a known ticker: USDC, WETH, DAI, CBBTC, USDBC, CBETH, AERO, EURC. Omit for the native ETH balance"},"address":{"type":"string","description":"0x address (40 hex) or an ENS name ending .eth"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"data":{"type":"object","properties":{"asset":{"type":"string"},"chain":{"type":"string"},"source":{"type":"string"},"address":{"type":"string"},"balance":{"type":"number"},"chain_id":{"type":"number"},"balance_wei":{"type":"string"}}},"paid":{"type":"boolean"},"tool":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"data":{"asset":"ETH","chain":"Base","source":"rpc:mainnet.base.org","address":"0x22DB3A9686EE5261e7Bf3ed4f91277232E8076e6","balance":0.000094829,"chain_id":8453,"balance_wei":"94829352850506"},"paid":true,"tool":"get_base_balance"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Lu48dibqgykcCABZp_S4x","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the token or native ETH balance for a wallet address or ENS name on Base or Ethereum mainnet, with decimals and symbol read live from the contract.","exampleAgentPrompt":"What's the USDC balance for vitalik.eth on Ethereum mainnet right now?","exampleUseCases":[{"title":"DeFi portfolio balance check","prompt":"How much USDC and native ETH does 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 have on Base?"},{"title":"ENS wallet token lookup","prompt":"What's the WETH balance for coinbase.eth on Ethereum mainnet?"},{"title":"Pre-transaction sufficiency check","prompt":"Does 0xAbCd1234...5678 have at least any DAI on Base before I trigger the transfer?"}],"resultDescription":"A JSON object containing the human-readable balance as a number, the raw balance in wei as a string, the token symbol, the asset name, the chain name, the chain ID, and the resolved wallet address. Decimals and symbol are fetched live from the contract so the value is always correctly scaled.","failureModes":["Invalid or malformed 0x address returns an error","ENS name not found or not resolved returns an error","Unknown or unsupported token ticker returns an error","ERC20 contract address on wrong chain returns zero or an error","Network timeout when querying on-chain contract","Unsupported chain value (only 'base' and 'ethereum' are valid)"],"whenToPreferThis":"Use this endpoint when you need a precise, correctly-scaled token or ETH balance for a specific wallet on Base or Ethereum mainnet — especially when the token might not use 18 decimals (e.g. USDC uses 6). It reads decimals() and symbol() live from the contract, avoiding the common bug of reporting balances 10^12 times too large. Prefer it over generic RPC calls when you want a clean, agent-ready numeric result without handling raw wei conversion yourself.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T12:51:55.358Z","isFirstParty":false,"canonicalSlug":"agentfeed-erc20-eth-wallet-balance-base-ethereum-1f4b2752"}