{"uid":"cap_-NhjgXIKieYlZKTgKXd_E","slug":"skills-onesource-io-a60a0039","name":"OneSource Token Total Supply","description":"Total supply of an ERC20 or ERC721 token contract via totalSupply (eth_call)","url":"https://skills.onesource.io/api/chain/total-supply","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"network":{"enum":["ethereum","sepolia","avax","megaeth","megaeth-testnet","base"],"type":"string","default":"ethereum"},"contract":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"}}},"responseSchema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["name","symbol","decimals","is_erc721","total_supply","contract_address"],"properties":{"name":{"type":"string"},"symbol":{"type":"string"},"decimals":{"type":"number"},"is_erc721":{"type":"boolean"},"total_supply":{"type":"string"},"contract_address":{"type":"string"}}},"meta":{"type":"object","required":["endpoint","request_id"],"properties":{"endpoint":{"type":"string"},"request_id":{"type":"string"}}}}},"example":{"request":{"network":"ethereum","contract":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"},"response":{"data":{"name":"USD Coin","symbol":"USDC","decimals":6,"is_erc721":false,"total_supply":"52402765504217914","contract_address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"},"meta":{"endpoint":"/api/chain/total-supply","request_id":"7685fd0756c95991"}}},"exampleRequest":{"network":"ethereum","contract":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"},"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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_WjOjhSezz989rNv-aXZnm","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the total supply of an ERC20 or ERC721 token contract by calling totalSupply on-chain via eth_call","exampleAgentPrompt":"What's the total supply of the USDC token on Ethereum — the contract address is 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48?","exampleUseCases":[{"title":"Check NFT collection minting progress","prompt":"Can you look up how many NFTs have actually been minted for the Pudgy Penguins collection? I need the total supply from the smart contract."},{"title":"Compare token supplies across networks","prompt":"I'm researching USDT — can you grab the total supply for the USDT contract on both Ethereum and Base so I can compare the distributions?"},{"title":"Validate token metadata before trade","prompt":"Before I swap into this token, pull up the total supply and decimals for the contract at 0x6B175474E89094C44Da98b954EedeAC495271d0F on Ethereum to make sure it's legit."}],"resultDescription":"Returns a JSON object with the token's name, symbol, decimals, total supply (as a raw integer string), whether it's an ERC721, and the contract address. For example, USDC on Ethereum returns name='USD Coin', symbol='USDC', decimals=6, total_supply='54863922761251119', is_erc721=false.","failureModes":["Invalid contract address format returns a 400 error","Contract address that doesn't implement totalSupply returns an error or null supply","Unsupported network value causes validation failure","Network RPC unavailability causes a timeout or 503","Non-token contract address (e.g. wallet or proxy with no ERC20 interface) may return unexpected results"],"whenToPreferThis":"Use this endpoint when you need on-chain totalSupply data for any ERC20 or ERC721 token on supported networks (Ethereum, Base, Avalanche, Sepolia, MegaETH). It also returns human-readable token metadata (name, symbol, decimals) in one call, making it ideal for DeFi analytics, NFT supply checks, or token research without running your own RPC node.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:44:38.651Z","isFirstParty":false}