{"uid":"cap_Ucql9-CuvzYvJvNLUxsTp","slug":"saylor-innovations-data-desk-erc-20-token-balance-a0a31914","name":"Saylor Innovations Data Desk – ERC-20 Token Balance","description":"ERC-20 token balance of a wallet on 16 EVM chains, raw and decimal-scaled, with the token symbol and name, read through balanceOf.","url":"https://saylorinnovations.com/api/chain/erc20-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":["chain","address","token"],"properties":{"chain":{"type":"string","description":"chain name (ethereum, base, arbitrum, optimism, polygon, bsc, avalanche, gnosis, linea, scroll, mantle, blast, sonic, celo, berachain, unichain) or chain id"},"token":{"type":"string","description":"the ERC-20 token contract address"},"address":{"type":"string","description":"the wallet to read"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object","required":["chain","chain_id","address","token","balance_raw","source"],"properties":{"name":{"type":["string","null"],"description":"token name"},"chain":{"type":"string","description":"the chain name that was queried"},"token":{"type":"string","description":"the token contract"},"source":{"type":"string","description":"where the data was read from"},"symbol":{"type":["string","null"],"description":"token symbol"},"address":{"type":"string","description":"the wallet that was read"},"balance":{"type":["string","null"],"description":"balance divided by 10^decimals"},"chain_id":{"type":"number","description":"EIP-155 chain id of that network"},"decimals":{"type":["number","null"],"description":"token decimals"},"balance_raw":{"type":"string","description":"balance in the token smallest unit"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.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_Y5h6CNJ8GLfMD4m8TXG8w","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 any of 16 supported EVM chains, including raw and decimal-scaled amounts, token symbol, and token name.","exampleAgentPrompt":"What's the USDC balance of wallet 0xAbC...123 on Base — give me both the raw amount and the human-readable decimal figure, and tell me the token name and symbol.","exampleUseCases":[{"title":"DeFi eligibility check before airdrop","prompt":"Check if wallet 0xDe...456 holds at least 1000 ARB tokens on Arbitrum — give me the exact balance in both raw and decimal form so I can see if they qualify."},{"title":"Portfolio tracker balance refresh","prompt":"Pull the current USDT balance on Polygon for wallet 0xFa...789, including the token symbol and decimals, so I can update the user's portfolio dashboard."},{"title":"Smart contract audit pre-flight","prompt":"Before we proceed, read the WETH balance of address 0x11...222 on Optimism from the actual contract using balanceOf — I need the raw value and the decimal-scaled amount."}],"resultDescription":"A JSON object containing the queried chain name and EIP-155 chain ID, the wallet address, the token contract address, the raw balance (smallest unit string), the decimal-scaled balance (string or null), token decimals, token symbol, token name, and a source field indicating where the data was read from (on-chain RPC).","failureModes":["Invalid or unsupported chain name/ID returns an error","Malformed wallet or token contract address returns an error","Token contract address that is not an ERC-20 may return null or zero balance","Network RPC unavailability causes a timeout or upstream error","Token with no decimals metadata returns null for balance and decimals fields"],"whenToPreferThis":"Use this endpoint when you need on-chain ERC-20 token balance data for a specific wallet across any of 16 supported EVM chains, particularly when you require both the raw smallest-unit value and the human-readable decimal-scaled amount together with token metadata (symbol, name, decimals) in a single call. Prefer this over generic RPC calls when you want a simple REST interface without managing Web3 providers or ABI encoding yourself.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T06:46:58.141Z","isFirstParty":false,"canonicalSlug":"saylor-innovations-data-desk-erc-20-token-balance-a0a31914"}