{"uid":"cap_rwCewkbJLMCjWzZc4M-WE","slug":"live-multi-token-wallet-balance-native-erc-20-unykorn-genesis402-96fadfb1","name":"Live Multi-Token Wallet Balance (Native + ERC-20) — UnyKorn Genesis402","description":"Live wallet balance on one chain: native coin plus up to 10 ERC-20 tokens in ONE call — Genesis402 / UnyKorn Operator Network","url":"https://twin.unykorn.org/chain/live-balance?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"params":{"type":"object","required":["address"],"properties":{"chain":{"enum":["ethereum","base","polygon","arbitrum","optimism","bsc","avalanche","gnosis","linea","scroll"],"type":"string","description":"EVM chain: ethereum | base | polygon | arbitrum | optimism | bsc | avalanche | gnosis | linea | scroll (default base)"},"tokens":{"type":"array","items":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"maxItems":10,"description":"up to 10 ERC20 contract addresses (array, or one comma-separated string)"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"0x-prefixed 40-hex EVM address"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_UZle249ll4gR-GfOnuzNR","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches a wallet's live native coin balance plus up to 10 ERC-20 token balances in a single call across 10 supported EVM chains","exampleAgentPrompt":"What's the live balance of wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum — give me the ETH balance plus the USDC (0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48) and WETH (0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2) token balances all in one shot?","exampleUseCases":[{"title":"DeFi portfolio snapshot","prompt":"Check the live balance of wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Polygon — I want the native MATIC plus balances for USDC at 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174 and USDT at 0xc2132D05D31c914a87C6611C10748AEb04B58e8F."},{"title":"Smart contract treasury audit","prompt":"Pull the current holdings of our treasury wallet 0xBE0eB53F46cd790Cd13851d5EFf43D12404d33E8 on Arbitrum, including the native ETH balance plus these 5 token contracts: 0xFF970A61A04b1cA14834A43f5dE4533eBDDB5CC8, 0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9, 0x2f2a2543B76A4166549F7aaB2e75Bef0aefC5B0f, 0x82aF49447D8a07e3bd95BD0d56f35241523fBab1, 0xDA10009cBd5D07dd0CeCc66161FC93D7c9000da1."},{"title":"User wallet balance check on Base","prompt":"What's the live balance of 0x742d35Cc6634C0532925a3b8D4C9C3Df9B0E4d11 on Base? Include the native ETH and also check USDC at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 and DAI at 0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb."}],"resultDescription":"Returns the wallet's live native coin balance (e.g. ETH, MATIC, BNB) plus the balance of each requested ERC-20 token contract, all queried simultaneously from on-chain state. Response includes token amounts, likely with symbol/decimals context, for each asset in the request.","failureModes":["Invalid or malformed wallet address (not a valid 0x EVM address) — returns validation error","Invalid ERC-20 contract address in the tokens array — may return zero balance or error for that token","Unsupported chain name — returns error; only the 10 listed chains are supported","More than 10 ERC-20 addresses provided — rejected by schema validation","Chain node unavailability or RPC timeout — returns upstream error","Payment not settled via x402 — returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need to check a wallet's native coin and multiple ERC-20 token balances atomically in a single API call, avoiding multiple round-trips. It is ideal for portfolio snapshots, treasury monitoring, or any agent workflow where latency and call cost matter across 10 major EVM chains. Prefer it over individual per-token balance calls or block explorer scraping when you need live, programmatic, pay-per-call access without API key setup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-26T04:10:33.312Z","isFirstParty":false,"canonicalSlug":"live-multi-token-wallet-balance-native-erc-20-unykorn-genesis402-96fadfb1"}