{"uid":"cap_8Mo-6_FrakNAu2-Fl1TX2","slug":"agent-data-tools-erc-20-token-balance-on-ethereum-531d6c0c","name":"Agent Data Tools: ERC-20 Token Balance on Ethereum","description":"ERC-20 token balance of a wallet on Ethereum (USDC, USDT, WETH or any token, via balanceOf): raw amount, decimals, symbol and the human-readable amount, live from the token contract. Use to check stablecoin or token holdings before a transfer or trade; for the native coin use eth_balance. Both inputs are 0x addresses (40 hex characters); no contract returns 404 and a non-ERC-20 contract 422, both uncharged.","url":"https://agent-data-tools.revmesh2074.workers.dev/eth/token-balance?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["token","address"],"properties":{"token":{"type":"string","description":"Token: a ticker such as USDC, USDT, WETH or DAI, or the 0x ERC-20 contract address"},"address":{"type":"string","description":"0x wallet address"}}},"responseSchema":{"type":"object","properties":{"raw":{"type":"string"},"chain":{"type":"string"},"token":{"type":"string"},"symbol":{"type":"string"},"address":{"type":"string"},"balance":{"type":"string"},"chainId":{"type":"number"},"decimals":{"type":"number"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USD","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_emYqD5PM1VznWMsDZcwWK","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","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 of a wallet address on Ethereum, including human-readable and raw amounts, symbol, and decimals.","exampleAgentPrompt":"What's the USDC balance (contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48) for the wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum?","exampleUseCases":[{"title":"Portfolio balance audit for DeFi agent","prompt":"Check how much USDC (contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48) the wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 currently holds on Ethereum."},{"title":"Token gate verification before access","prompt":"Does the wallet 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B hold any of the governance token at contract 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 on Ethereum? I need to verify if they qualify for access."},{"title":"Automated treasury monitoring","prompt":"Fetch the current WETH balance (contract 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2) for our treasury wallet 0x3f5CE5FBFe3E9af3971dD833D26bA9b5C936f0bE so I can track how much ETH-equivalent we're holding on-chain."}],"resultDescription":"Returns a JSON object containing the wallet's token balance as a human-readable string (e.g. '2.5'), the raw on-chain integer value, the token symbol, contract address, wallet address, number of decimals, chain name ('Ethereum'), and chain ID (1).","failureModes":["Invalid or malformed token contract address returns an error","Invalid or malformed wallet address returns an error","Token contract does not exist on Ethereum results in an error or zero balance","Network or RPC timeout may return a service error","Calling with a non-ERC-20 contract address may return unexpected results"],"whenToPreferThis":"Use this endpoint when you need to check the balance of a specific ERC-20 token for a specific wallet address on Ethereum, without needing an API key or account setup. It is ideal for lightweight, pay-per-call agent workflows that need on-chain balance data at very low cost ($0.001 per call). Prefer this over full node integrations or heavier blockchain indexers when you only need a single token balance lookup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T07:10:17.165Z","isFirstParty":false,"canonicalSlug":"agent-data-tools-erc-20-token-balance-on-ethereum-531d6c0c"}