{"uid":"cap_zhVqu3B7Ji84c10lkV13n","slug":"base-token-total-supply-583cd80a","name":"Base Token Total Supply","description":"Free Base USDC total-supply sample. The paid $0.0024 API returns exact raw ERC-20 or ERC-721 total supply from bounded read-only contract calls.","url":"https://appearing-clinics-show-wrote.trycloudflare.com/base-total-supply-sample","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":[],"properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"unprobed","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"unknown","summary":"price unknown","primary":{"kind":"unknown","protocol":"x402","network":"base","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"unknown","protocol":"x402","network":"base","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_XF55RuF4vRIn9i8JUtYP9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the exact raw ERC-20 or ERC-721 total token supply for a contract on the Base network via a bounded read-only call","exampleAgentPrompt":"What is the current total supply of USDC on the Base network? Just give me the raw on-chain number from the ERC-20 contract.","exampleUseCases":[{"title":"Monitor token inflation on Base","prompt":"Check the total supply of this ERC-20 token on Base — contract address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 — I want to know exactly how many tokens exist right now."},{"title":"Audit NFT collection size","prompt":"How many NFTs have been minted from the Base ERC-721 collection at contract 0x1234abcd... ? I need the exact raw total supply from the contract."},{"title":"Track stablecoin supply growth","prompt":"What's the on-chain total supply of USDC on Base right now? I'm tracking how the supply changes week over week."}],"resultDescription":"A raw integer representing the total number of tokens minted (total supply) for the specified ERC-20 or ERC-721 contract on the Base network, returned directly from a read-only contract call with no rounding or formatting.","failureModes":["Invalid or non-existent contract address returns an error or zero","Contract is not ERC-20 or ERC-721 compliant and does not expose totalSupply()","Network congestion may cause delayed responses","Free sample endpoint may return USDC-specific data only, not arbitrary contracts"],"whenToPreferThis":"Choose this endpoint when you need the exact raw on-chain total token supply for a contract deployed on Base (Coinbase L2), especially for ERC-20 stablecoins or ERC-721 NFT collections. Prefer it over general Ethereum endpoints when the contract is specifically on Base, and over off-chain data sources when you need trustless, contract-level accuracy rather than an aggregator's cached value.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T17:26:25.036Z","isFirstParty":false}