{"uid":"cap_uRp7AojJiXWon6R6AYnAk","slug":"bitcoin-total-supply-lookup-74799fe2","name":"Bitcoin Total Supply Lookup","description":"Total Bitcoin in circulation (raw value as returned by upstream, unit to be verified empirically), via Blockchain.info stats API","url":"https://finance-api.kdlcfa.workers.dev/btc-total-supply","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.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_lIBYZxO6mtvxNhfq5f0jL","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 total number of Bitcoin currently in circulation, sourced from the Blockchain.info stats API","exampleAgentPrompt":"What is the total amount of Bitcoin currently in circulation according to Blockchain.info?","exampleUseCases":[{"title":"Bitcoin supply dashboard widget","prompt":"Pull the current total Bitcoin in circulation so I can display it on my crypto dashboard."},{"title":"Monitor BTC supply approaching cap","prompt":"How many bitcoins have been mined so far? I want to track how close we are to the 21 million hard cap."},{"title":"Macroeconomic crypto research","prompt":"Get me the current circulating supply of Bitcoin from Blockchain.info — I need it for a report comparing BTC monetary policy to gold supply."}],"resultDescription":"A raw numeric value representing the total number of Bitcoin units currently in circulation, as returned by the Blockchain.info stats API. The exact unit (BTC vs satoshis) should be verified empirically, but typically represents the total mined supply.","failureModes":["Upstream Blockchain.info stats API unavailable — proxy returns 5xx error","Unit ambiguity: value may be in satoshis rather than whole BTC, requiring downstream division by 100,000,000","Delayed or stale data if Blockchain.info cache hasn't updated recently","Payment failure due to insufficient x402 USDC balance, resulting in 402 response"],"whenToPreferThis":"Choose this endpoint when you need a simple, single scalar representing total circulating Bitcoin supply, sourced directly from Blockchain.info. Prefer this over general crypto market APIs when you specifically need the on-chain supply metric rather than price or market cap data. Best for dashboards, research, or monitoring use cases that require a quick, cheap data point without complex query construction.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:54:48.069Z","isFirstParty":false}