# Glassnode ETH2 Epoch Height Metric

> Glassnode ETH2 Epoch Height Metric 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-15).

Returns the total number of Ethereum 2.0 epochs ever included in the main blockchain, sampled at 24h resolution.

## Facts

- Endpoint: GET https://x402.glassnode.com/v1/metrics/eth2/epoch_height
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/glassnode-eth2-epoch-height-metric-145ee2f2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nW_ubKuQ_9kTWQdl5cGfm

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-eth2-epoch-height-metric-145ee2f2
```

Example prompt: Can you pull the Glassnode ETH2 epoch height data for Ethereum in JSON format so I can see how many total epochs have accumulated on the beacon chain?

## When to prefer this

Use this endpoint when you need authoritative on-chain Ethereum 2.0 epoch height data sourced from Glassnode, specifically for tracking cumulative beacon chain epochs over time at daily resolution. Prefer over general blockchain explorers when you need structured time-series data ready for analysis or charting.

## Known failure modes

- Missing required 'a' query parameter (must be 'ETH') returns a 400 or validation error
- Invalid format value for 'f' parameter returns an error
- Payment not included or insufficient USDC payment results in 402 Payment Required
- Rate limiting or quota exceeded returns 429
- Glassnode data unavailable or delayed returns 503 or empty data

## How this service works

Epoch Height — The epoch height, i.e. the total number of epochs ever included in the main blockchain. Data by Glassnode.

## Output

Returns a time-series array of objects, each containing a Unix timestamp (t) and the epoch height value (v) representing the cumulative number of Ethereum 2.0 epochs included in the main blockchain at that point in time, sampled at 24-hour intervals.

## 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": [
        "ETH"
       ],
       "type": "string",
       "description": "Asset symbol, e.g. BTC, ETH"
      },
      "f": {
       "enum": [
        "csv",
        "json"
       ],
       "type": "string",
       "description": "Response format: json or csv"
      },
      "i": {
       "enum": [
        "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-eth2-epoch-height-metric-145ee2f2/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)