{"uid":"cap_qKOeDAVoIBU1iZAotGdWq","slug":"erc-20-token-balance-lookup-multi-chain-evm-97507d25","name":"ERC-20 Token Balance Lookup (Multi-Chain EVM)","description":"Balance of one ERC-20 token in a wallet with symbol and decimals. Works on Base, Ethereum, Arbitrum, Optimism, Polygon, BNB Chain, Avalanche, Gnosis, Linea, Scroll, Sonic and Unichain.","url":"https://api.vextorium.com/evm-saldo-token-pago?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"red":{"enum":["base","ethereum","arbitrum","optimism","polygon","bnb","avalanche","gnosis","linea","scroll","sonic","unichain"],"type":"string","description":"Chain (default base)"},"token":{"type":"string"},"direccion":{"type":"string"}}},"responseSchema":{"type":"json","example":{"red":"base","saldo":1.541325,"token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","nombre":"USD Coin","wallet":"0xb9f06D2734B7E9D7b21B64C4D8b95bd774b71aCf","simbolo":"USDC","decimales":6,"saldo_bruto":"1541325"}},"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_JPkqNG36RMSnJjAAwDH76","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":"Returns the ERC-20 token balance for a given wallet address on a specified EVM chain, including token name, symbol, decimals, and raw/formatted balance.","exampleAgentPrompt":"What's the USDC balance (token address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) for wallet 0xb9f06D2734B7E9D7b21B64C4D8b95bd774b71aCf on Base — give me the formatted balance plus the symbol and decimals?","exampleUseCases":[{"title":"DeFi bot pre-trade balance check","prompt":"Before I execute this swap, check how many USDC tokens (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) my wallet 0xb9f06D2734B7E9D7b21B64C4D8b95bd774b71aCf has on Arbitrum."},{"title":"Portfolio dashboard token snapshot","prompt":"Pull the WETH balance (token 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2) for wallet 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B on Ethereum, including the token name, symbol, and how many decimals it uses."},{"title":"Airdrop eligibility balance verification","prompt":"Check whether wallet 0x1234567890abcdef1234567890abcdef12345678 holds any ARB tokens (0x912CE59144191C1204E64559FE8253a0e49E6548) on Arbitrum — show me the exact formatted balance and raw amount."}],"resultDescription":"Returns a JSON object with the chain name, wallet address, token contract address, token name, symbol, number of decimals, human-readable balance (saldo), and raw integer balance string (saldo_bruto). All fields may be null if the token or wallet is not found.","failureModes":["Invalid wallet address format returns null fields or an error","Token contract address not found on the specified chain returns null balance","Unsupported chain identifier causes validation failure","Network timeout or RPC unavailability results in an error response","Wallet with zero token holdings returns saldo of 0 and saldo_bruto of '0'"],"whenToPreferThis":"Use this endpoint when you need to query an ERC-20 token balance for a specific wallet on any major EVM-compatible chain (Base, Ethereum, Arbitrum, Optimism, Polygon, BNB Chain, Avalanche, Gnosis, Linea, Scroll, Sonic, Unichain) and want the result enriched with token metadata (name, symbol, decimals) in a single call. Prefer this over raw RPC calls when you need a clean JSON response without managing blockchain node connections. Best for DeFi automation, portfolio tracking, pre-transaction checks, and airdrop verification.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-20T18:53:47.376Z","isFirstParty":false,"canonicalSlug":"erc-20-token-balance-lookup-multi-chain-evm-97507d25"}