{"uid":"cap_fjeZGPXtMkm41JCtCWYkS","slug":"sitecheck-evm-erc-20-token-balance-60540a98","name":"SiteCheck EVM ERC-20 Token Balance","description":"ERC-20 balance of an address for one token contract on a chain: token name, symbol, decimals, raw and human amount, and a USD value when Coinbase has a spot price for the symbol. Only the token you name is read; the native balance is in /api/evm/address.","url":"https://api.sitecheck-api.workers.dev/api/evm/balance?utm_source=zero.xyz","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":"base (default), ethereum, arbitrum, optimism or polygon"},"token":{"type":"string","description":"ERC-20 contract address, 0x…"},"address":{"type":"string","description":"EVM address, 0x…"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"raw":"44783666","chain":"base","token":{"name":"USD Coin","symbol":"USDC","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","decimals":6},"amount":44.783666,"holder":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","source":"https://base-rpc.publicnode.com (eth_call name, symbol, decimals, balanceOf); Coinbase spot price for the symbol","usdPrice":1,"usdValue":44.78,"checkedAt":"2026-10-14T04:49:18.151Z","disclaimer":"Information only, not financial advice."}},"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_kdAvtp6FjckRjJaBbtB_g","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":"Fetches the ERC-20 token balance for a given EVM wallet address on a specified chain, including USD value","exampleAgentPrompt":"What's the USDC balance (contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Base, and what is it worth in USD right now?","exampleUseCases":[{"title":"Portfolio USD value snapshot","prompt":"Tell me how much USDC (contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) the wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 holds on Base and its current USD value."},{"title":"Cross-chain token audit","prompt":"Check the USDT balance on Arbitrum for wallet 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B — give me the raw amount and what it's worth in dollars."},{"title":"DeFi position monitoring","prompt":"What is the current balance of the WETH token at contract 0x4200000000000000000000000000000000000006 for address 0x1234567890abcdef1234567890abcdef12345678 on Optimism, in both token units and USD?"}],"resultDescription":"Returns a JSON object with the raw token balance (integer string), human-readable amount, token metadata (name, symbol, contract address, decimals), the holder address, chain identifier, USD spot price, total USD value, the RPC source used, and a timestamp of when the check was performed.","failureModes":["Invalid or non-checksummed EVM address returns an error","Unrecognized or unsupported chain name defaults to Base or returns error","ERC-20 contract address not found on specified chain returns null balance or error","RPC node unavailability causes timeout or 503","Token with no Coinbase price feed returns USD value as null","Missing required query parameters (address or token) returns 400"],"whenToPreferThis":"Choose this endpoint when you need the ERC-20 token balance for a specific wallet on an EVM-compatible chain (Base, Ethereum, Arbitrum, Optimism, Polygon) along with real-time USD valuation in a single call. It is ideal for agents that need to check portfolio balances, verify token holdings, or assess DeFi positions without building their own RPC infrastructure. Prefer it over raw RPC calls when you also want token metadata and USD conversion bundled together.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T06:44:25.537Z","isFirstParty":false,"canonicalSlug":"sitecheck-evm-erc-20-token-balance-60540a98"}