{"uid":"cap_iZ1GR3V-es_lD43w-bvI3","slug":"blockchain-com-explorer-bitcoin-blocks-size-chart-40984b34","name":"Blockchain.com Explorer — Bitcoin Blocks Size Chart","description":"Paid AI-agent access to Blockchain.com Explorer API","url":"https://api.blockchain.info/explorer-gateway-kt/x402/charts/blocks-size?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":"Blockchain Size","unit":"MB","period":"day","status":"ok","values":[{"x":1704067200,"y":642318.4},{"x":1704153600,"y":642480.1}],"description":"The total size of all block headers and transactions. Not including database indexes."}},"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_DaiJPu9rhVB5p4XGAtAAw","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 historical Bitcoin block size chart data from Blockchain.com Explorer, with configurable timespan, rolling average, and output format","exampleAgentPrompt":"Pull the Bitcoin block size chart from Blockchain.com for the past 3 years using a 24-hour rolling average and give me the data in JSON format.","exampleUseCases":[{"title":"Bitcoin block size trend research","prompt":"Get me the Bitcoin block size history from Blockchain.com for the last year with an 8-hour rolling average in JSON so I can see how block utilization has changed."},{"title":"Export block size data for spreadsheet","prompt":"Download Bitcoin block size data from Blockchain.com for the past 7 days in CSV format with a 24-hour rolling average so I can import it into my spreadsheet."},{"title":"Monitor recent block size changes","prompt":"Check the Blockchain.com block size chart for the last 24 hours using a 1-hour rolling average and tell me if there are any unusual spikes in block size."}],"resultDescription":"Returns a time-series dataset of Bitcoin block sizes, either as structured JSON (with optional metadata like chart name, description, and units) or raw CSV (timestamp + value columns). Data points can be sampled for reduced volume. Covers the requested timespan with the specified rolling average window applied.","failureModes":["Invalid timespan format returns a 400 error","Invalid rollingAverage format returns a 400 error","Payment not provided or insufficient USDC results in 402 Payment Required","Network timeout if Blockchain.com upstream is slow","Invalid format enum value (not json or csv) returns a 400 error"],"whenToPreferThis":"Choose this endpoint when you need authoritative Bitcoin block size historical data sourced directly from Blockchain.com Explorer, especially when you need flexible timespan control, rolling average smoothing, or CSV export. Prefer this over third-party aggregators when data provenance from a recognized blockchain data provider matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T12:41:46.940Z","isFirstParty":false,"canonicalSlug":"blockchain-com-explorer-bitcoin-blocks-size-chart-40984b34"}