{"uid":"cap_nW_ubKuQ_9kTWQdl5cGfm","slug":"glassnode-eth2-epoch-height-metric-145ee2f2","name":"Glassnode ETH2 Epoch Height Metric","description":"Epoch Height — The epoch height, i.e. the total number of epochs ever included in the main blockchain. Data by Glassnode.","url":"https://x402.glassnode.com/v1/metrics/eth2/epoch_height","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":["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"}}}}}}}},"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_fcStaUC2-M2lbeZkRrFQc","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 number of Ethereum 2.0 epochs ever included in the main blockchain, sampled at 24h resolution.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Track daily ETH2 epoch progression","prompt":"Can you fetch the historical Ethereum 2.0 epoch height time series from Glassnode so I can chart how the beacon chain has progressed day by day since the merge?"},{"title":"Check current beacon chain epoch count","prompt":"What is the total number of epochs that have been included on the Ethereum beacon chain so far? Pull the latest data from Glassnode for me."},{"title":"Analyze ETH2 staking milestone history","prompt":"I want to analyze key milestones in Ethereum 2.0 staking — can you grab the full epoch height time series from Glassnode so I can identify when major epoch thresholds were crossed?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T07:08:07.838Z","isFirstParty":false}