{"uid":"cap_-QZyvVUxp_VY2hsxj8yCz","slug":"vextorium-evm-token-supply-7ce451ee","name":"Vextorium EVM Token Supply","description":"558 pay-per-call data APIs for AI agents: Solana and EVM on-chain data, tokenized stocks, DeFi, Hyperliquid, economy and official statistics, FX, validation, web and developer tools. Pay in USDC via x402.","url":"https://api.vextorium.com/v1/evm-token-supply?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"network":{"enum":["base","ethereum","arbitrum","optimism","polygon","bnb","avalanche","gnosis","line","scroll","sonic","unichain"],"type":"string","description":"Chain (default base)"},"contract":{"type":"string"}}},"responseSchema":{"type":"json","example":{"name":"USD Coin","supply":4349847314.410437,"symbol":"USDC","network":"base","contract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","decimals":6,"gross_supply":"4349847314410437"}},"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_avtFPWdb5vIRpTXWRxIQU","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 the name, symbol, decimals, and circulating supply of any ERC-20 token on 12 supported EVM chains given a contract address.","exampleAgentPrompt":"What is the total circulating supply, symbol, and decimals for the USDC contract at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base?","exampleUseCases":[{"title":"Stablecoin supply monitoring dashboard","prompt":"How many USDC tokens are currently in circulation on Ethereum? The contract address is 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48."},{"title":"DeFi token due diligence","prompt":"I'm researching a DeFi protocol — can you pull the name, symbol, total supply, and decimals for the token at 0x6B175474E89094C44Da98b954EedeAC495271d0F on Ethereum so I can verify its on-chain data?"},{"title":"Cross-chain supply comparison","prompt":"Fetch the total supply of the ARB token on Arbitrum using contract address 0x912CE59144191C1204E64559FE8253a0e49E6548, and also get the same data for MATIC on Polygon at 0x0000000000000000000000000000000000001010."}],"resultDescription":"A JSON object containing the token's name, symbol, decimals, human-readable floating-point supply, raw gross supply string (no decimals applied), the queried contract address, and the network — e.g. {name:'USD Coin', symbol:'USDC', supply:4349847314.41, decimals:6, gross_supply:'4349847314410437', network:'base', contract:'0x833589...'}.","failureModes":["Invalid or non-ERC-20 contract address returns null fields or an error","Unsupported network name results in a validation error","Contract exists but has no standard totalSupply function returns null supply","Network congestion may cause RPC timeout","Malformed contract address (wrong checksum or length) returns an error"],"whenToPreferThis":"Use this endpoint when you need authoritative on-chain ERC-20 token supply data — including name, symbol, decimals, and both human-readable and raw integer supply — from any of 12 supported EVM chains. Prefer it over price-feed APIs when you specifically need supply figures rather than price, and over generic RPC calls when you want a structured JSON response without handling ABI encoding.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T12:44:49.878Z","isFirstParty":false,"canonicalSlug":"vextorium-evm-token-supply-7ce451ee"}