{"uid":"cap_TeRbdM0g61FSqxqrvK58b","slug":"chainverdict-erc-20-supply-lookup-ebfe3491","name":"ChainVerdict ERC-20 Supply Lookup","description":"Total and circulating supply for an ERC-20 on Base, read live from chain with decimals applied and the block height returned.","url":"https://chainverdict.xyz/v1/data/supply/:addr","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"},"pathParams":{"type":"object","required":["addr"],"properties":{"addr":{"type":"string","description":"ERC-20 contract address on Base"}}},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","additionalProperties":true}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.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_4WnP1QFxYvEyvmWSEY-ST","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 total and circulating supply for an ERC-20 token on Base, with decimals applied and block height included, read live from chain.","exampleAgentPrompt":"What's the total and circulating supply of the ERC-20 token at contract address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base, with decimals applied?","exampleUseCases":[{"title":"DeFi dashboard token supply display","prompt":"Pull the live total and circulating supply for the USDC token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base — I need the decimal-adjusted numbers and the block height they were read at."},{"title":"Token launch supply verification","prompt":"We just deployed our ERC-20 at 0xAbCd1234AbCd1234AbCd1234AbCd1234AbCd1234 on Base. Can you confirm what total supply is showing on-chain right now, with decimals applied?"},{"title":"Circulating supply monitoring for analytics","prompt":"Check the current circulating supply of the token at contract 0x4200000000000000000000000000000000000006 on Base and tell me which block height the data is from."}],"resultDescription":"Returns the total supply and circulating supply of the specified ERC-20 token on Base, with token decimals already applied so values are human-readable, along with the block number at which the data was read from the chain.","failureModes":["Invalid or non-ERC-20 contract address returns an error or zero values","Contract address does not exist on Base (wrong chain or mistyped address)","RPC node transient failure causing a read error","Token with non-standard decimal implementation may return unexpected precision"],"whenToPreferThis":"Use this endpoint when you need live, decimal-adjusted ERC-20 token supply data specifically on the Base network with a specific block height reference for auditability. Prefer it over generic block explorer scraping for reliable structured output, or when building agents that need to verify token economics programmatically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:44:56.286Z","isFirstParty":false}