{"uid":"cap_jZquJ4bF2poIlZ8HhJKlT","slug":"x402-gateway-cross-chain-balance-6f28fa20","name":"x402-gateway: cross_chain_balance","description":"x402-gateway tool: cross_chain_balance","url":"https://x402.freeq.one/tools/cross_chain_balance","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"chains":{"type":"array","items":{"type":"string"},"description":"Chains to query: eth, arb, base, polygon, opt"},"address":{"type":"string","description":"Ethereum address"}}},"responseSchema":{"type":"json","example":{"result":{}}},"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_G5W4Sco2bBPjFNJDP_8f_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches the token balances of a wallet address across multiple blockchain networks in a single call","exampleAgentPrompt":"What token balances does wallet 0xAbC1234...5678 hold across Ethereum, Base, and Polygon? Show me everything including small balances.","exampleUseCases":[{"title":"DeFi portfolio cross-chain snapshot","prompt":"Check all the token balances for my wallet 0x1234...abcd across Ethereum, Base, Arbitrum, and Optimism — I want to see everything I'm holding and roughly how much it's worth."},{"title":"Whale wallet monitoring for research","prompt":"Pull the full cross-chain token balances for address 0xDeadBeef...9999 across all supported chains — I'm researching this wallet's holdings for a market report."},{"title":"Multi-chain asset reconciliation","prompt":"I need to reconcile my assets — grab the cross-chain balances for 0xMy...Wallet on Ethereum, Base, and Polygon so I can see where my USDC and ETH are sitting."}],"resultDescription":"Returns a structured breakdown of token balances held by the specified wallet address across multiple blockchains, including token symbols, amounts, chain names, and optionally USD values for each holding.","failureModes":["Invalid or malformed wallet address returns an error","Unsupported chain requested returns partial results or error for that chain","Payment not fulfilled via x402 results in 402 Payment Required response","Wallet has no holdings on requested chains returns empty balance lists","Network timeout on one or more chains may return partial data","Rate limiting or provider downtime may cause transient failures"],"whenToPreferThis":"Choose this endpoint when you need to aggregate a wallet's token holdings across multiple blockchain networks in a single API call rather than querying each chain separately. It is ideal for portfolio dashboards, whale tracking, DeFi analytics, and any scenario requiring a unified multichain balance view. Prefer it over single-chain balance APIs when the user or address may hold assets on more than one network. The pay-per-call x402 model ($0.002 USDC) means no subscription is needed for occasional lookups.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T00:44:58.570Z","isFirstParty":false}