{"uid":"cap_CMMFAAFY7mtdIXUuKmdFg","slug":"avasis-eth-multi-balance-lookup-d89faa33","name":"Avasis ETH Multi-Balance Lookup","description":"Wallet multi-balance on Ethereum (chain 1, $0.02): address -> ETH + USDC + up to 10 ERC-20s (addresses or symbols: USDC, USDT, DAI, WETH, WBTC) in ONE batched read: raw + units, USD per asset and total (Chainlink, pegs, Dexscreener), tx_count, is_contract, empty flag, gas affordability (ETH transfer cost at 2x base fee, can_pay_eth_transfer). Phrases: wallet balance, multi balance, usdc balance, eth balance. GET or POST JSON. Per-token fail-soft; RPC down 502, never charged.","url":"https://agents.avasis.ai/v1/eth/multi-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":"optional; must be ethereum / 1 on this route"},"tokens":{"type":"string","description":"optional comma-separated ERC-20 addresses or known symbols (USDC, USDT, DAI, WETH, WBTC), up to 10; USDC is always included"},"address":{"type":"string","description":"the wallet or contract to read (0x + 40 hex)"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["chain","address","eth","usdc","tokens","totals","gas","headline"],"properties":{"eth":{"type":"object"},"gas":{"type":"object"},"kind":{"type":"string"},"rail":{"type":"string"},"usdc":{"type":"object"},"chain":{"type":"string"},"empty":{"type":"boolean"},"tokens":{"type":"array"},"totals":{"type":"object"},"address":{"type":"string"},"chain_id":{"type":"integer"},"headline":{"type":"string"},"tx_count":{"type":["integer","null"]},"is_contract":{"type":["boolean","null"]},"block_number":{"type":"integer"},"also_available":{"type":"object"}}}}}}},"responseSchema":{"type":"json","example":{"eth":{"usd":94.43,"wei":"42100000000000000","price":2242.9,"amount":"0.0421","price_source":"chainlink ETH/USD (latestRoundData)"},"gas":{"note":"21000 gas at 2x the current base fee + 0.001 gwei tip; excludes the Base L1 data fee (~$0.0003-0.001 per tx); contract calls cost more: /v1/evm/gas-ops prices them","base_fee_gwei":0.005,"can_pay_eth_transfer":true,"eth_transfer_cost_eth":"0.000000231","eth_transfer_cost_usd":0.0005181,"eth_transfer_cost_wei":"231000000000","eth_transfers_affordable":182251},"kind":"multi-balance","rail":"evm-rails-1","usdc":{"usd":15115.05,"error":null,"amount":"15115.05","address":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"},"chain":"ethereum","empty":false,"reads":{"rpc":"fixture","calls":8,"elapsed_ms":0},"tokens":[{"raw":"15115050000","usd":15115.05,"error":null,"known":"USDC (Circle)","price":1,"amount":"15115.05","symbol":"USDC","address":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","decimals":6,"price_source":"stablecoin peg (known issuer)"},{"raw":"250000000000000000","usd":560.73,"error":null,"known":"WETH (canonical)","price":2242.9,"amount":"0.25","symbol":"WETH","address":"0x4200000000000000000000000000000000000006","decimals":18,"price_source":"chainlink ETH/USD (latestRoundData)"},{"raw":"120000","usd":131.85,"error":null,"known":"cbBTC (Coinbase)","price":109876.5,"amount":"0.0012","symbol":"cbBTC","address":"0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf","decimals":8,"price_source":"dexscreener aerodrome (liquidity $12,345,678)"}],"totals":{"usd":15902.06,"note":"ETH + priced tokens at current prices","complete":true,"unpriced":[]},"address":"0xf977814e90da44bfa03b6295a0616a897441acec","chain_id":1,"headline":"0xf977…acec on Base: 0.0421 ETH ($94.43), 15,115.05 USDC, 0.25 WETH, 0.0012 cbBTC; total $15,902.06; gas for 182251 ETH transfers","tx_count":499417,"is_contract":false,"block_number":53354727,"block_timestamp":1793498801}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_STUWa3fK-26g48LPMmGL5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns ETH balance, USDC balance, and up to 10 ERC-20 token balances with USD prices for any Ethereum wallet or contract address in one call.","exampleAgentPrompt":"What's the ETH, USDC, WETH, and WBTC balance of 0xf977814e90da44bfa03b6295a0616a897441acec on Ethereum, and what's the total USD value?","exampleUseCases":[{"title":"DeFi portfolio snapshot for a wallet","prompt":"Can you check the full token portfolio of 0xf977814e90da44bfa03b6295a0616a897441acec on Ethereum — I want ETH, USDC, WETH, and any other major tokens, all priced in USD with a total?"},{"title":"Gas affordability check before a transaction","prompt":"Before I send a transaction from 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B, can you check how much ETH it holds and whether it can afford gas for standard ETH transfers?"},{"title":"Smart contract treasury audit","prompt":"Pull the ETH and stablecoin balances for the contract at 0x3300f198988e4C9C63F75dF86De36421f06af8c1 on Ethereum — include USDC, USDT, and DAI — and tell me the total USD value held."}],"resultDescription":"Returns a JSON object with ETH balance (amount, wei, USD value, Chainlink price), USDC balance, an array of requested ERC-20 token balances (amount, raw, decimals, USD price, price source), aggregated totals in USD, gas cost estimates and how many ETH transfers the wallet can afford, transaction count, block number, contract/EOA flag, and a human-readable headline string summarizing the portfolio.","failureModes":["Invalid or malformed wallet address returns an error","Unsupported chain specified (only Ethereum/chain 1 on this route)","More than 10 token addresses requested exceeds the limit","Unknown token symbol not in the known-symbols list may return null price","RPC timeout or node unavailability may delay response","Token with no liquidity may return unpriced entry in totals.unpriced array"],"whenToPreferThis":"Choose this endpoint when you need a complete multi-asset Ethereum portfolio snapshot — ETH plus multiple ERC-20s with live USD prices — in a single x402 micropayment call with no API key or account setup. It is ideal for agents that need to assess wallet holdings, check gas affordability, or audit contract treasuries on Ethereum mainnet. Prefer it over individual balance checks when you need aggregated USD totals and gas estimates simultaneously at $0.02 per call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T18:30:03.724Z","isFirstParty":false,"canonicalSlug":"avasis-eth-multi-balance-lookup-d89faa33"}