{"uid":"cap_rlik4I18QL62BySleC24O","slug":"x402-agent-hub-multi-chain-evm-portfolio-balance-lookup-a8cce6d3","name":"x402 Agent Hub: Multi-Chain EVM Portfolio Balance Lookup","description":"One call returns an address's native coin, USDC and USDT balances on Base, Ethereum, Arbitrum, Optimism, Polygon, BSC and Avalanche (or a 'chains' subset), plus a total stablecoin USD figure, instead of 21 separate reads. Chains whose RPC fails are listed in chainsFailed. You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement.","url":"https://x402-agent-hub.x402-agent-hub.workers.dev/v1/chain/portfolio?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":{"chains":{"type":"string","description":"Optional comma-separated subset, e.g. base,arbitrum. Defaults to all 7 chains."},"address":{"type":"string","description":"0x-prefixed wallet or contract address."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"totals":{"stablecoinUsd":12.5},"address":"0x1721E9841257A34DbDBA407D4DBA3a727a02d072","balances":[{"chain":"base","native":{"raw":"1250000000000000","symbol":"ETH","decimals":18,"formatted":"0.00125"},"chainId":8453,"stablecoins":[{"raw":"12500000","symbol":"USDC","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","decimals":6,"formatted":"12.5"}]}],"chainsFailed":[],"chainsQueried":["base","ethereum","arbitrum"]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_16bK4Y8GSEZwnGCuofGhm","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns native coin, USDC, and USDT balances for an EVM address across up to 7 chains (Base, Ethereum, Arbitrum, Optimism, Polygon, BSC, Avalanche) plus a total stablecoin USD figure in a single call.","exampleAgentPrompt":"What are the ETH, USDC, and USDT balances for wallet 0x1721E9841257A34DbDBA407D4DBA3a727a02d072 across Base, Ethereum, and Arbitrum? I just need a quick portfolio snapshot including the total stablecoin value.","exampleUseCases":[{"title":"DeFi wallet portfolio snapshot","prompt":"Give me a full breakdown of native coin and stablecoin balances for 0xAbCd1234...5678 across all 7 EVM chains — I want to see the total USDC and USDT combined in USD."},{"title":"Pre-transfer liquidity check","prompt":"Before I send funds, can you check if wallet 0x1721E9841257A34DbDBA407D4DBA3a727a02d072 has enough USDC on Base and Arbitrum to cover a $10 payment?"},{"title":"Stablecoin treasury audit","prompt":"Check the USDC and USDT holdings for our treasury wallet 0xDead...Beef on Ethereum, Polygon, and Optimism only, and tell me the combined stablecoin total in USD."}],"resultDescription":"A JSON object containing the queried address, an array of per-chain balance objects (each with native coin raw/formatted amount, symbol, decimals, and stablecoin entries for USDC/USDT), a totals object with combined stablecoinUsd, a list of chains successfully queried, and a chainsFailed array listing any chains whose RPC was unreachable.","failureModes":["Invalid or malformed 0x address returns an error without settlement charge","RPC failure on one or more chains lists those in chainsFailed but returns data for successful chains","Requesting an unsupported chain name in the 'chains' parameter may be ignored or cause partial results","Network timeout on all chains could result in empty balances array with all chains in chainsFailed","Upstream RPC degradation may return stale or incomplete balance data"],"whenToPreferThis":"Choose this endpoint when you need a single-call multi-chain EVM balance aggregation rather than making 21 separate RPC calls yourself. It is ideal for portfolio dashboards, pre-transaction liquidity checks, treasury audits, or any agent workflow that needs native + stablecoin balances across Base, Ethereum, Arbitrum, Optimism, Polygon, BSC, and Avalanche simultaneously. It is not suited for ERC-20 tokens other than USDC/USDT, historical balance lookups, or non-EVM chains.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-14T12:33:39.284Z","isFirstParty":false,"canonicalSlug":"x402-agent-hub-multi-chain-evm-portfolio-balance-lookup-a8cce6d3"}