# Glassnode Total Block Size Sum

> Glassnode Total Block Size Sum is a paid API for AI agents from x402.glassnode.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-13).

Returns the total size in bytes of all blocks created on a blockchain within a given time period.

## Facts

- Endpoint: GET https://x402.glassnode.com/v1/metrics/blockchain/block_size_sum
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/glassnode-total-block-size-sum-1b212f81
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TJRF4wEceHTOeePmqNGBH

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability glassnode-total-block-size-sum-1b212f81
```

Example prompt: Can you pull the total block size sum for Bitcoin from Glassnode at a weekly interval in JSON format?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Total Block Size — The total size, in bytes, of all blocks created within the time period. Data by Glassnode.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
       }
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/glassnode-total-block-size-sum-1b212f81/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.glassnode.com](https://www.zero.xyz/host/x402.glassnode.com/llms.txt)