{"uid":"cap_smes-9QCUdHoCHUounead","slug":"blockchain-com-explorer-api-average-block-size-chart-4dea5d3c","name":"Blockchain.com Explorer API – Average Block Size Chart","description":"Paid AI-agent access to Blockchain.com Explorer API","url":"https://api.blockchain.info/explorer-gateway-kt/x402/charts/avg-block-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":"Average Block Size","unit":"MB","period":"day","status":"ok","values":[{"x":1704067200,"y":1.62},{"x":1704153600,"y":1.71}],"description":"The average block size in MB."}},"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_xi5U7Yok8TxHkdUce-VSI","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 average block size chart data over a configurable time period and rolling average window","exampleAgentPrompt":"Pull the Blockchain.com average Bitcoin block size chart for the past year using a 24-hour rolling average and return it as JSON.","exampleUseCases":[{"title":"Bitcoin network capacity research","prompt":"Show me the average Bitcoin block size trend over the last 3 years with a 24-hour rolling average, formatted as JSON so I can analyze capacity utilization."},{"title":"Weekly block size snapshot for a report","prompt":"Get me average Bitcoin block size data for the past 7 days from Blockchain.com with an 8-hour rolling average in CSV format for my weekly report."},{"title":"Monitoring block size growth over time","prompt":"I want to track how Bitcoin average block sizes have grown over the last year — pull the chart data from Blockchain.com with a 24-hour rolling average and include metadata."}],"resultDescription":"Returns a time-series dataset of average Bitcoin block sizes, including timestamps and values. In JSON mode, may include chart metadata such as name, description, and units. In CSV mode, returns raw two-column data (timestamp, value). The rolling average window and timespan control data granularity and coverage.","failureModes":["Invalid timespan format returns a 400 error","Unsupported rollingAverage value may return an error or unexpected results","Payment not processed (402) if x402 payment header is missing or insufficient","Rate limiting if too many requests are made in a short period","Network timeouts for very large timespans with sampling disabled"],"whenToPreferThis":"Use this endpoint when you need historical Bitcoin average block size time-series data from Blockchain.com's Explorer, especially when you need configurable time windows, rolling averages, or both JSON and CSV output formats. Prefer this over generic blockchain APIs when you specifically need block size metrics (not transaction counts, fees, or price data) and when you need fine-grained control over the rolling average window.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T12:41:39.944Z","isFirstParty":false,"canonicalSlug":"blockchain-com-explorer-api-average-block-size-chart-4dea5d3c"}