{"uid":"cap_KCJfpYDJiaZ5ovCYI6X4b","slug":"erc-20-token-balance-lookup-ethereum-base-f67adc57","name":"ERC-20 Token Balance Lookup (Ethereum/Base)","description":"ERC-20 token balance for any wallet — USDC, USDT, DAI, or any token contract — via balanceOf eth_call, with decimals applied. Ethereum or Base mainnet. Pay 0.003 USDC.","url":"https://app.heinrichstech.com/v1/cdp/chain/erc20-balance","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"chain":{"type":"string","description":"ethereum | base"},"token":{"type":"string","description":"0x… ERC-20 contract"},"address":{"type":"string","description":"0x… holder"}}},"responseSchema":null,"example":{"request":{"chain":"ethereum","token":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"},"response":{"op":"erc20-balance","raw":"31227137","chain":"ethereum","token":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","balance":"31.227137","decimals":6}},"exampleRequest":{"chain":"ethereum","token":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"},"tags":["x402"],"displayCostAmount":"0.003","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.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_4uPaKjhX1w0_VdUjqSOki","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 of a wallet address for any token contract on Ethereum or Base mainnet, with decimals applied.","exampleAgentPrompt":"What's the USDC balance of wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum mainnet?","exampleUseCases":null,"resultDescription":"Returns the decimal-adjusted ERC-20 token balance for the specified wallet address and token contract on the requested chain (Ethereum or Base), derived from a live balanceOf eth_call.","failureModes":["Invalid or non-ERC-20 contract address returns an error or zero balance","Unsupported chain value (not 'ethereum' or 'base') returns a validation error","Malformed 0x address triggers a bad request error","Payment of 0.003 USDC not provided results in 402 Payment Required","Token contract with non-standard decimals may return unexpected scaled values","Network congestion or RPC unavailability causes timeout or 5xx error"],"whenToPreferThis":"Use this endpoint when you need a real-time, decimal-adjusted ERC-20 token balance for a specific wallet on Ethereum or Base mainnet without running your own node. Ideal for agents that need to verify holdings, check liquidity, or gate actions on token balance thresholds. Prefer this over general blockchain RPC calls when you want a simple, pre-parsed balance without handling raw uint256 and decimals yourself.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:44:53.364Z","isFirstParty":false}