{"uid":"cap_e6G4TdPeEGZJA_oBXHkmR","slug":"blockchain-info-total-bitcoins-chart-api-c366c127","name":"Blockchain.info Total Bitcoins Chart API","description":"Paid AI-agent access to Blockchain.com Explorer API","url":"https://api.blockchain.info/explorer-gateway-kt/x402/charts/total-bitcoins?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"cors":{"type":"boolean","default":false,"description":"Enable CORS headers"},"format":{"enum":["json","csv"],"type":"string","default":"json","description":"Response format:\n- `json` — Returns structured JSON with metadata and values\n- `csv` — Returns raw CSV data with timestamp and value columns (no metadata)\n"},"sampled":{"type":"boolean","default":true,"description":"Apply sampling to reduce data points"},"metadata":{"type":"boolean","default":false,"description":"Include metadata in response"},"timespan":{"type":"string","default":"1y","example":"1y","description":"Time period (e.g., \"24h\", \"7d\", \"1y\", \"3y\")"},"rollingAverage":{"type":"string","default":"8h","example":"8h","description":"Rolling average window (e.g., \"8h\", \"24h\")"}}},"responseSchema":{"type":"json","format":"application/json","example":{"name":"Total Bitcoins","unit":"BTC","period":"day","status":"ok","values":[{"x":1704067200,"y":19589375},{"x":1704153600,"y":19589500}],"description":"The total number of bitcoins that have been mined"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_jkpEgjaWQafyTf60A3Zrq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a time-series chart of the total number of bitcoins that have been mined over a specified period","exampleAgentPrompt":"Pull the total bitcoins mined chart from Blockchain.com for the past 3 years with a 24-hour rolling average, sampled to reduce data points.","exampleUseCases":[{"title":"Bitcoin supply research dashboard","prompt":"Can you get me the total bitcoins mined data from Blockchain.com for the last 3 years with a 24-hour rolling average? I want to plot how the circulating supply has grown over time."},{"title":"Daily crypto market briefing","prompt":"Fetch the total bitcoin supply chart for the past 7 days with an 8-hour rolling average — I want to see how much BTC has been added to circulation this week."},{"title":"Long-term Bitcoin issuance analysis","prompt":"Get the Blockchain.com total bitcoins mined chart going back 1 year, with metadata included, so I can analyze the rate of new coin issuance over time."}],"resultDescription":"A JSON object containing the chart name ('Total Bitcoins'), unit ('BTC'), period granularity (e.g. 'day'), a status field, a human-readable description, and an array of {x: Unix timestamp, y: total BTC mined} data points covering the requested timespan with the specified rolling average applied.","failureModes":["Invalid timespan format returns an error or empty values array","Unsupported chart format enum value results in a 400 bad request","Network or gateway timeout if the blockchain data backend is slow","Payment failure (402) if x402 payment is not properly submitted","Malformed rollingAverage string may return default behavior or error"],"whenToPreferThis":"Choose this endpoint when you need historical time-series data specifically about the cumulative total number of bitcoins mined, sourced directly from Blockchain.com's explorer data. It is ideal for supply-side Bitcoin analytics, issuance trend research, and charting circulating supply over custom timespans. Prefer this over generic crypto price APIs when the goal is supply-curve analysis rather than price or transaction data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:39:21.983Z","isFirstParty":false,"canonicalSlug":"blockchain-info-total-bitcoins-chart-api-c366c127"}