{"uid":"cap_nHNAQerDxybK3ig0Ym21f","slug":"token-supply-base-ethereum-51ed580c","name":"Token Supply - Base & Ethereum","description":"Pay-per-call x402 APIs for AI agents: OpenAI-compatible LLM chat, perp funding and arbitrage spreads, crypto prices, gas, FX, Solana SPL mint audit, token price by contract, x402 delivery-receipt verification, web search, clean page extraction, batch tools and deterministic code-security scanning. USDC on Base or Solana, no signup, no API key, from $0.0001 a call.","url":"https://scanpay-edge.alextaghiashvili.workers.dev/api/v1/token-supply?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","required":["address"],"properties":{"address":{"type":"string"},"network":{"enum":["base","ethereum"],"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","network":"base","product":"scanpay.token_supply","chain_id":"eip155:8453","decimals":6,"price_usd":0.002,"total_supply":1000000,"total_supply_raw":1000000000000}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ZFJi1vqNOqK2gleqvK1i-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches the total supply and decimals for an ERC-20 or ERC-721 token on Base or Ethereum via eth_call","exampleAgentPrompt":"What is the total supply and decimals for the USDC token contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base?","exampleUseCases":[{"title":"DeFi dashboard token metrics","prompt":"Can you pull the total supply and decimal places for the token at contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base so I can calculate market cap?"},{"title":"NFT collection mint count check","prompt":"How many NFTs have been minted so far from the ERC-721 contract 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D on Ethereum?"},{"title":"Token audit supply verification","prompt":"I need to verify the on-chain total supply and decimals for the ERC-20 at address 0x6B175474E89094C44Da98b954EedeAC495271d0F on Ethereum mainnet — can you fetch that directly from the chain?"}],"resultDescription":"Returns a JSON object containing the token contract address, network name, chain ID (EIP-155 format), number of decimals, total supply as a human-readable number, total supply as a raw big-integer string, and the per-call price in USD.","failureModes":["Invalid or non-existent contract address returns an error or empty supply","Unsupported network (not Base or Ethereum) results in an error response","Contract address that is not an ERC-20/721 (e.g. plain EOA or non-token contract) may return zero or fail eth_call","RPC node unavailability on Base or Ethereum may cause timeout or 5xx error","Missing required query parameters (address or network) returns a validation error"],"whenToPreferThis":"Choose this endpoint when you need a quick, pay-per-call on-chain total supply or decimals lookup for an ERC-20 or ERC-721 token on Base or Ethereum, without needing to run your own node or manage RPC infrastructure. It is ideal for agents that need sporadic token metadata lookups rather than high-frequency bulk data. Prefer it over general blockchain RPCs when cost predictability ($0.002–$0.005 per call) and simplicity matter.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-01T06:52:52.259Z","isFirstParty":false,"canonicalSlug":"token-supply-base-ethereum-51ed580c"}