{"uid":"cap_UU8KR3fTIGA5iBDLHDaNl","slug":"x402-base-tools-eth-erc-20-balance-lookup-1d7944ad","name":"x402 Base Tools – ETH & ERC-20 Balance Lookup","description":"The ETH balance and ERC-20 balances of an address on Base, for the tokens you name or a default list of well-known tokens (USDC, WETH, cbBTC, AERO, DAI, USDT, DEGEN, VIRTUAL and others), with USD values for ETH, stablecoins and up to five other held tokens priced from their pools.","url":"https://base.kagurazaka.dev/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_nSra8EdtZi1-gw62c1RFk","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 ETH and ERC-20 token balances for a Base address, with USD values for ETH, stablecoins, and up to five held tokens priced from on-chain pools.","exampleAgentPrompt":"What's the current ETH balance and total USD portfolio value for the Base wallet 0x5672...? Include USDC, WETH, and AERO balances if they have any.","exampleUseCases":[{"title":"DeFi portfolio snapshot for a user","prompt":"Can you check the full token balances for Base wallet 0xABCD...1234 and tell me the total USD value, including ETH, USDC, and any other tokens they hold?"},{"title":"Stablecoin balance check before a payment","prompt":"Before I send a payment, can you check how much USDC and DAI the address 0x9988...aabb has on Base right now?"},{"title":"Monitoring a specific token holding","prompt":"How much AERO and VIRTUAL does the Base address 0x1122...3344 currently hold, and what are they worth in USD?"}],"resultDescription":"A JSON object containing the address's ETH balance as a string, an array of token objects (each with symbol, amount, and USD value), the ETH USD value, and a total_usd figure summing all priced holdings.","failureModes":["Invalid or malformed wallet address returns an error","Unknown token symbol or address not found in the default list returns no entry for that token","Token without a liquid Uniswap v3 or Aerodrome pool may have no USD value","More than 20 tokens specified returns a validation error","Network congestion on Base may cause slow or timed-out RPC reads","Address with zero balances returns empty token array and zero total_usd"],"whenToPreferThis":"Use this endpoint when you need both raw token balances and USD valuations for a Base address in a single call. It is ideal for portfolio summaries, pre-payment checks, and DeFi dashboards on Base. Prefer it over separate price and balance calls when you want aggregated USD totals including ETH and a broad default token list without specifying every address.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:35:50.125Z","isFirstParty":false,"canonicalSlug":"x402-base-tools-eth-erc-20-balance-lookup-1d7944ad"}