{"uid":"cap_nG1XT-SZpK5lzq-OIRL0u","slug":"foundry-erc-20-native-token-balance-lookup-a2a8bafa","name":"Foundry ERC-20 & Native Token Balance Lookup","description":"ERC-20 token balance for any wallet on Base, Ethereum, Arbitrum, Optimism or Polygon (USDC, USDT, DAI, WETH or any address), plus native balance. Input: 'wallet token chain'.","url":"https://minty-sprout.onrender.com/v1/erc20-balance?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"input":{"type":"string","maxLength":8000,"description":"'<wallet> <token symbol or address> <chain>'"}}},"responseSchema":{"type":"json","example":{"chain":"ethereum","token":"USDC","wallet":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","balance":39.192124,"decimals":6,"raw_balance":"39192124","token_address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","native_balance":5.779567498611001}},"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_6qgY6dkrrz0inPZ8st5Ag","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":"Returns the ERC-20 token balance (and native coin balance) for any wallet address on Base, Ethereum, Arbitrum, Optimism, or Polygon, supporting USDC, USDT, DAI, WETH, or any custom token contract address.","exampleAgentPrompt":"What's the USDC balance for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum, and also show me its native ETH balance?","exampleUseCases":[{"title":"DeFi portfolio balance snapshot","prompt":"Check the USDC and native ETH balance for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum so I can see their current holdings."},{"title":"Cross-chain stablecoin audit","prompt":"What's the USDT balance of wallet 0xAbC123...def456 on Polygon? I want to verify their on-chain stablecoin position."},{"title":"Custom token contract balance check","prompt":"Look up how many tokens wallet 0x1234...5678 holds for the contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Base, and tell me the native balance too."}],"resultDescription":"A JSON object containing the chain name, token symbol, wallet address, human-readable balance (float), token decimals, raw balance string, token contract address, and the wallet's native coin balance (e.g. ETH on Ethereum/Base/Arbitrum/Optimism, MATIC on Polygon).","failureModes":["Invalid or malformed wallet address returns an error","Unsupported chain name causes a lookup failure","Unknown token symbol with no contract address provided may return zero or error","Network timeout or RPC node unavailability on the target chain","Incorrect token contract address returns zero balance or error"],"whenToPreferThis":"Use this endpoint when you need on-chain ERC-20 or native token balances across the major EVM networks (Base, Ethereum, Arbitrum, Optimism, Polygon) without managing your own RPC infrastructure. Ideal for agents that need to verify wallet holdings, audit DeFi positions, or check stablecoin balances programmatically at low cost ($0.002 per call).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-01T06:57:43.057Z","isFirstParty":false,"canonicalSlug":"foundry-erc-20-native-token-balance-lookup-a2a8bafa"}