{"uid":"cap_49RKVEDm1T5msLsHOIgqx","slug":"kette-multi-chain-wallet-balance-reader-7b3ca0d9","name":"Kette Multi-Chain Wallet Balance Reader","description":"Reads token balances of one wallet on several chains from a public index and the native balance from the node itself. The same asset exists on several chains in different versions; canonical and bridged issues are reported separately and still summed, because both together are the answer. Every chain carries its block height, without which the sum cannot be checked. A chain that cannot be reached drops out with a reason under chains_failed and the call stays valid. Limits: the index exists for E","url":"https://kette.halowerk.com/wallet/balances","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"chains":{"type":"array","items":{"type":"string"},"maxItems":4,"description":"Chains to query. Default: ethereum, base, arbitrum, optimism."},"wallet":{"type":"string","description":"Wallet address, 0x followed by 40 hex characters."},"group_by":{"enum":["asset","chain"],"type":"string","default":"asset","description":"Which grouping to put first. Both are always returned."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.006","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.006/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_iJlaTQoChwD5_xpBHdrpQ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.006","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Reads token balances across multiple EVM chains for a single wallet address, reporting canonical and bridged token versions separately, with native balances and block heights per chain.","exampleAgentPrompt":"What's my total USDC and ETH balance for wallet 0xABC...123 across Ethereum, Base, Arbitrum, Optimism, and Polygon — show canonical and bridged USDC separately, and tell me the block height for each chain?","exampleUseCases":[{"title":"Cross-chain portfolio snapshot","prompt":"Give me a full balance breakdown for my wallet 0xDEAD...BEEF across Ethereum, Base, Arbitrum, and Optimism — I want to see native ETH, all ERC-20 tokens, and know which chains were reachable."},{"title":"Bridged vs canonical USDC audit","prompt":"For wallet 0x1234...5678, show me how much USDC I hold on Base and Arbitrum, broken out by canonical Circle USDC versus any bridged versions, so I can decide where to consolidate."},{"title":"DeFi rebalancing pre-check","prompt":"Before I rebalance, check wallet 0xABCD...EF01 on Ethereum, Polygon, and BNB Smart Chain — I need token balances and block heights so I know the data is current and which chains are actually responding."}],"resultDescription":"Returns per-chain token balances including native coin balance and ERC-20 token balances, with canonical and bridged versions of the same asset reported separately but also summed. Each chain entry includes the current block height. Chains that could not be reached are listed under chains_failed with a reason, and the overall call remains valid even if some chains drop out.","failureModes":["Chain unreachable: chain drops out with a reason in chains_failed, remainder of call is still valid","Wallet address not found or invalid: error returned for the address","Index unavailable: token index temporarily down, balances may be incomplete","Rate limiting or quota exceeded: call rejected with payment or limit error","Unsupported chain requested: chain not covered by the index returns an error"],"whenToPreferThis":"Use this endpoint when you need a single call to aggregate token and native balances for one wallet across multiple EVM chains simultaneously, especially when you need to distinguish canonical vs bridged token versions and need block height confirmation per chain for data freshness verification. Prefer over single-chain RPC calls when multi-chain aggregation, partial failure tolerance, and bridged asset disambiguation are all required at once.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:44:48.304Z","isFirstParty":false}