{"uid":"cap_n8N2NMPLKqjn59XlmkBI1","slug":"financial-data-x402-ethereum-total-supply-6cbb7cd6","name":"Financial Data x402 – Ethereum Total Supply","description":"Pay-per-call stock, macro, on-chain, and crypto data over the x402 protocol. USDC on Base or Solana, no API keys, no subscriptions.","url":"https://x402financialdata.com/eth-supply","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"required":{"type":"string"},"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"as_of":"2026-07-31T03:43:30.000000","chain":"eth","total_supply":122373866.2178,"total_supply_wei":"122373866217800000000000000"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oyU3PeNT04LyIvQ0AL-wg","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the current total supply of Ether (ETH) on the Ethereum mainnet, in both human-readable decimal and raw wei units","exampleAgentPrompt":"What is the current total supply of ETH on Ethereum mainnet right now, including the value in wei?","exampleUseCases":[{"title":"Ethereum supply tracker dashboard","prompt":"Pull the latest total supply of ETH on Ethereum mainnet so I can update my crypto dashboard with the current circulating supply figure."},{"title":"On-chain monetary policy analysis","prompt":"What is the exact current total supply of Ether, including the raw wei amount? I'm doing a monetary policy analysis comparing ETH issuance over time."},{"title":"DeFi protocol collateral check","prompt":"I need to know the total ETH supply on-chain right now — I'm building a report on Ethereum's collateral base for a DeFi lending protocol."}],"resultDescription":"A JSON object containing the chain identifier ('eth'), the total ETH supply as a floating-point decimal (e.g. 122373866.22 ETH), the total supply expressed in wei as a string, and a timestamp indicating when the data was last updated.","failureModes":["Payment not received or insufficient USDC balance — returns HTTP 402","Network or upstream data source unavailability — may return 5xx error","Stale data if the upstream on-chain indexer has a lag — timestamp may be slightly behind real-time","Malformed request headers — returns 4xx error"],"whenToPreferThis":"Choose this endpoint when you need a quick, no-subscription, pay-per-call lookup of Ethereum's total supply with both decimal and wei precision. Ideal for agents or pipelines that query supply infrequently and want to avoid API key management, or when operating in a crypto-native payment context using USDC on Base or Solana via the x402 protocol.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:44:29.474Z","isFirstParty":false}