{"uid":"cap_FN10tXyUNbH9uLE9_kirK","slug":"signals-edge-report-erc20-token-balance-lookup-f58206d3","name":"signals.edge.report ERC20 Token Balance Lookup","description":"Get ERC20 token balance for any wallet and token contract on Base (or Ethereum). Returns balance, decimals, and symbol via balanceOf. Use for live ERC20 holdings checks without an API key.","url":"https://signals.edge.report/v1/erc20-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","token"],"properties":{"chain":{"type":"string","description":"Chain: base (default) or ethereum"},"token":{"type":"string","description":"ERC20 token contract address"},"address":{"type":"string","description":"Wallet address to read ERC20 balance for"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"chain":"base","token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","wallet":"0x0000000000000000000000000000000000000001","balance":"12.5","product":"edge-signals-erc20-balance","decimals":6,"balanceRaw":"12500000"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_qW66jUUOR88ixb-cR9Txx","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the ERC20 token balance, decimals, and symbol for any wallet address and token contract on Base or Ethereum.","exampleAgentPrompt":"What's the USDC balance for wallet 0xAbC...123 on Base right now? Pull it from the ERC20 balanceOf call using the USDC contract address.","exampleUseCases":[{"title":"DeFi agent pre-trade balance check","prompt":"Before executing the swap, check how many USDC tokens wallet 0x1234...abcd holds on Base — use the USDC contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 to get the live ERC20 balance."},{"title":"Portfolio tracker for multiple ERC20s","prompt":"What is the current WETH balance on Ethereum for wallet 0xDEAD...BEEF? Use the WETH contract address 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 to fetch the balanceOf result."},{"title":"Agentic payment eligibility verification","prompt":"Check whether wallet 0x9999...FFFF has at least 50 DAI on Base before I send the payment — look up the DAI ERC20 balance using its contract address on Base."}],"resultDescription":"Returns a JSON object containing the token balance (as a raw integer or decimal-adjusted number), the token's decimal places, and the token symbol — representing the live on-chain ERC20 holdings of the specified wallet.","failureModes":["Invalid or malformed wallet address returns an error or zero balance","Invalid token contract address (non-ERC20 or wrong chain) causes a failed call or empty result","Unsupported chain value returns an error","Network congestion or RPC unavailability may cause timeouts","Payment failure (x402) blocks the request if USDC balance is insufficient"],"whenToPreferThis":"Choose this endpoint when you need a fast, keyless, on-chain ERC20 balance check on Base or Ethereum without setting up your own RPC connection. It is ideal for AI agents operating in DeFi workflows that need live token holdings data before executing swaps, payments, or risk assessments. Prefer it over full wallet bundle endpoints when you only need a single token balance rather than a multi-asset snapshot.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:30:31.168Z","isFirstParty":false}