{"uid":"cap_Lcyfh-xcAb3L-cKr6-V05","slug":"erc-20-token-balance-with-decimals-and-symbol-53536312","name":"ERC-20 Token Balance with Decimals and Symbol","description":"ERC-20 balance with decimals and symbol","url":"https://santyvv-x402.santyvv1993.workers.dev/api/chain/token-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","properties":{}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_4CRpEZc_bYOTJlcUdaTFn","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","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 an address along with the token's decimals and symbol","exampleAgentPrompt":"What's the ERC-20 token balance for wallet address 0xAbC...123 holding USDC (contract 0xA0b...eB4) on Ethereum, including the decimals and symbol?","exampleUseCases":[{"title":"Portfolio token balance snapshot","prompt":"Check the USDC balance for wallet 0x742d35Cc6634C0532925a3b844Bc454e4438f44e on Ethereum — give me the balance with the correct decimals and the token symbol."},{"title":"DeFi protocol user balance check","prompt":"I need the DAI token balance for address 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe including how many decimals it uses and the symbol, so I can display the real human-readable amount."},{"title":"Automated wallet monitoring alert","prompt":"Every hour, fetch the LINK token balance at contract 0x514910771AF9Ca656af840dff83E8264EcF986CA for my wallet 0x1f9090aaE28b8a3dCeaDf281B0F12828e676c326 and alert me if it drops below 100 tokens."}],"resultDescription":"Returns the raw on-chain ERC-20 token balance for the specified wallet address, along with the token's decimal places and ticker symbol, enabling conversion to a human-readable balance amount.","failureModes":["Invalid or malformed wallet/contract address returns an error","Non-ERC-20 contract address may return unexpected or empty data","Unsupported chain or network not available returns an error","Rate limiting or payment failure returns a 402 or 429 response","Node/RPC timeout if the underlying chain is congested"],"whenToPreferThis":"Use this endpoint when you need both the raw ERC-20 token balance AND the token metadata (decimals and symbol) in a single call, saving an extra round-trip compared to fetching balance and metadata separately. Ideal for agents that need to display human-readable token amounts without knowing the token's decimal precision in advance.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T12:55:02.692Z","isFirstParty":false,"canonicalSlug":"erc-20-token-balance-with-decimals-and-symbol-53536312"}