{"uid":"cap_kPmZ7ISUqz9AgJlmYLlQT","slug":"bitcoin-network-btc-supply-c700ed5e","name":"Bitcoin Network BTC Supply","description":"Bitcoin issued supply, block subsidy, percent of 21 million mined and the next halving, computed exactly from protocol rules.","url":"https://bitcoin-network.x402tookit.com/btc-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":[],"properties":{"unit":{"type":"string","description":"Headline unit: btc (default) or sats"},"height":{"type":"integer","description":"Block height to compute at (default: current tip)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"capBtc":{"type":["null","number"]},"height":{"type":["null","number"]},"source":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"issuedBtc":{"type":["null","number"]},"sourceUrl":{"type":["null","string"]},"disclaimer":{"type":["null","string"]},"issuedSats":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"subsidyBtc":{"type":["null","number"]},"halvingEpoch":{"type":["null","number"]},"percentOfCap":{"type":["null","number"]},"nextSubsidyBtc":{"type":["null","number"]},"usedCurrentTip":{"type":["boolean","null"]},"nextHalvingHeight":{"type":["null","number"]},"blocksUntilHalving":{"type":["null","number"]},"estimatedDaysUntilHalving":{"type":["null","number"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_3uHIw2HmsvKoXUZMK74Ak","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns Bitcoin's issued supply, block subsidy, percent of 21M cap mined, and next halving details, computed exactly from protocol rules.","exampleAgentPrompt":"What percentage of Bitcoin's 21 million cap has been mined so far, and how many days until the next halving? Show me the figures in BTC.","exampleUseCases":[{"title":"Halving countdown for investor report","prompt":"How many blocks and estimated days are left until the next Bitcoin halving, and what will the new block subsidy be afterward?"},{"title":"Current circulating supply check","prompt":"What is the total amount of Bitcoin that has been issued so far, and what percentage of the 21 million cap does that represent?"},{"title":"Historical supply at specific block","prompt":"What was Bitcoin's issued supply and block subsidy at block height 700000? Give me the numbers in BTC."}],"resultDescription":"Returns a JSON object with the current (or specified) block height, total issued supply in BTC and satoshis, the 21M cap in BTC, percent of cap mined, current block subsidy, next block subsidy, halving epoch number, next halving block height, blocks until halving, estimated days until halving, and metadata fields like source, disclaimer, and degraded status.","failureModes":["Invalid or future block height returns an error or null values","If the live tip cannot be fetched, degraded flag may be set and cached/estimated values used","Unsupported unit value (not 'btc' or 'sats') may return an error or default to BTC","Network timeouts may result in partial or null response fields"],"whenToPreferThis":"Choose this endpoint when you need precise, protocol-derived Bitcoin supply and halving metrics — including exact subsidy schedules, percent of cap mined, and halving countdown — computed deterministically from Bitcoin's consensus rules rather than scraped from a third-party explorer. Ideal for financial reports, dashboards, or any agent task requiring authoritative on-chain monetary policy figures.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T13:08:12.057Z","isFirstParty":false,"canonicalSlug":"bitcoin-network-btc-supply-c700ed5e"}