{"uid":"cap_TJRF4wEceHTOeePmqNGBH","slug":"glassnode-total-block-size-sum-1b212f81","name":"Glassnode Total Block Size Sum","description":"Total Block Size — The total size, in bytes, of all blocks created within the time period. Data by Glassnode.","url":"https://x402.glassnode.com/v1/metrics/blockchain/block_size_sum","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":["a"],"properties":{"a":{"enum":["BTC","ETH"],"type":"string","description":"Asset symbol, e.g. BTC, ETH"},"c":{"enum":["native"],"type":"string","description":"Currency for denominated values, e.g. usd, native"},"f":{"enum":["csv","json"],"type":"string","description":"Response format: json or csv"},"i":{"enum":["1month","1w","24h"],"type":"string","description":"Time interval / resolution, e.g. 24h, 1w, 1month"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"array","items":{"type":"object","properties":{"t":{"type":"number"},"v":{"type":"number"}}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8kvgF1so0vQGR2lsvg-oi","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the total size in bytes of all blocks created on a blockchain within a given time period.","exampleAgentPrompt":"Can you pull the total block size sum for Bitcoin from Glassnode at a weekly interval in JSON format?","exampleUseCases":null,"resultDescription":"A time-series array of objects, each containing a Unix timestamp (t) and the total block size value in bytes (v) for that time period, representing the aggregate size of all blocks created during the specified interval.","failureModes":["Missing required 'a' (asset) parameter returns 400 error","Invalid asset symbol (not BTC or ETH) returns validation error","Invalid interval value returns 400 error","Payment not included or insufficient USDC results in 402 Payment Required","Rate limiting may occur with excessive calls returning 429","Service unavailability returns 503"],"whenToPreferThis":"Use this endpoint when you need aggregate blockchain data throughput metrics — specifically the total cumulative byte size of all blocks over a period — for BTC or ETH. Prefer over mean block size when you want the total volume rather than average. Best for monitoring blockchain growth, network congestion analysis, or comparing data throughput trends over time.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T13:09:33.279Z","isFirstParty":false}