{"uid":"cap_iPNZMelOfNnQHwBxcbv79","slug":"x402-base-tools-address-balance-2b91c5a9","name":"x402 Base Tools – Address Balance","description":"Base mainnet data for agents, read live from the chain and paid per call in USDC: gas prices and costs, token prices from Uniswap and Aerodrome pools, balances, token info, transaction decoding, x402 payment checks, EIP-3009 authorization status, Basenames and address profiles. Lookups of things that do not exist are not charged.","url":"https://wt7tysfcmjm8fpzl.68r.lambda-web.us-east-1.on.aws/v1/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":{"tokens":{"type":"string","description":"comma separated token addresses or symbols (up to 20); default well-known tokens"},"address":{"type":"string","description":"the wallet or contract address"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"eth":{},"tokens":{},"address":{},"total_usd":{},"eth_usd_value":{}}}}}}},"responseSchema":{"type":"json","example":{"eth":"0.0001","tokens":[{"amount":"2.89","symbol":"USDC","usd_value":2.89}],"address":"0x5672...","total_usd":3.13,"eth_usd_value":0.24}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_BEYTJ-nmZqOC9FhdEayIV","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the ETH balance and ERC-20 token balances of a Base address, with USD valuations for ETH, stablecoins, and up to five other held tokens priced from on-chain pools.","exampleAgentPrompt":"What's the current ETH balance and total USD portfolio value for the Base address 0x5672...? Also include USDC, WETH, and cbBTC balances.","exampleUseCases":[{"title":"DeFi portfolio snapshot for a user","prompt":"Can you check the full token balances and USD value of my Base wallet 0xABCD...1234? I want to see ETH, USDC, WETH, and any other tokens I'm holding."},{"title":"Stablecoin balance check before payment","prompt":"Before I send a payment, can you confirm how much USDC and DAI the address 0x9988...7766 holds on Base right now?"},{"title":"Token gate verification for dApp access","prompt":"Does the Base address 0x1122...3344 hold at least 100 DEGEN or any VIRTUAL tokens? Check their balances for me."}],"resultDescription":"A JSON object containing the ETH balance as a string, an array of token objects (each with symbol, amount, and usd_value), the queried address, the ETH USD value, and a total_usd figure summing ETH plus all priced tokens.","failureModes":["Invalid or malformed wallet address returns an error","Token symbol not recognized defaults to the well-known list rather than failing","More than 20 tokens specified in the comma-separated list may be rejected","Tokens with no liquidity pool on Base may return without a USD value","Network or Lambda timeout if Base RPC is slow","Non-Base (e.g. Ethereum mainnet) addresses return Base-chain data only, not cross-chain balances"],"whenToPreferThis":"Use this endpoint when you need a one-call portfolio snapshot of any Base address, including ETH plus multiple ERC-20 balances with USD pricing — especially when you want well-known DeFi tokens (USDC, WETH, cbBTC, AERO, DEGEN, VIRTUAL, etc.) without having to specify each one. Prefer it over raw RPC calls when USD valuation is needed, or over a generic token price endpoint when you want balances and prices together in a single response.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:34:34.063Z","isFirstParty":false,"canonicalSlug":"x402-base-tools-address-balance-2b91c5a9"}