{"uid":"cap_AlrkpJq-HK1qjX97cmD5l","slug":"x402node-multichain-native-erc20-token-balance-26cbf813","name":"x402node Multichain Native & ERC20 Token Balance","description":"Native coin balance for any address on Ethereum, Base, Arbitrum, Optimism or Polygon, optionally an ERC20 token balance with symbol and decimals. wallet balance, eth balance, erc20 token balance, check address balance, multichain balance","url":"https://api.x402node.dev/chain/balance","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":"ethereum, base (default), arbitrum, optimism, polygon"},"token":{"type":"string","description":"Optional ERC20 contract address for token balance"},"address":{"type":"string","description":"Wallet address (required)"}}}},"additionalProperties":false}}},"responseSchema":null,"example":{"request":{"chain":"ethereum","address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"},"response":{"_hint":"x402 paid endpoints for AI agents — x402node.dev (utilities) · cn402.com (Chinese culture)","chain":"ethereum","native":{"wei":"5690764439481747771","formatted":"5.690764439481747771"},"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"}},"exampleRequest":{"chain":"ethereum","address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"},"tags":["x402"],"displayCostAmount":"0.004","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_mEPNd7bQkCDx3XtEEUZgS","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the native coin balance (ETH, MATIC, etc.) or ERC20 token balance for any wallet address on Ethereum, Base, Arbitrum, Optimism, or Polygon","exampleAgentPrompt":"What's the current ETH balance for wallet address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on the Base network, and also check its USDC balance using token contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913?","exampleUseCases":null,"resultDescription":"Returns the native coin balance (e.g. ETH in wei and formatted) for the given address on the specified chain. If an ERC20 contract address is provided, returns the token balance along with the token symbol and decimals.","failureModes":["Invalid or malformed wallet address returns an error","Unsupported chain identifier returns an error","Invalid ERC20 contract address returns an error or zero balance","RPC node unavailable leads to timeout or 5xx error","Rate limiting or payment failure returns 402 or 429"],"whenToPreferThis":"Use this endpoint when you need on-chain balance data for a wallet across Ethereum, Base, Arbitrum, Optimism, or Polygon — either for native coins or any ERC20 token. Prefer this over general-purpose blockchain explorers when you need a simple, low-latency programmatic balance check without scraping an explorer UI.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:45:01.066Z","isFirstParty":false}