# Ethereum Beat

> The pulse of Ethereum — a heartbeat, not a ticker. A live, free, open-source instrument for the Ethereum network: protocol health, usage and neutrality metrics — no prices, no market talk. The visual pulse is genuinely synced to Ethereum's 12-second slots.

All data is served from open endpoints with CORS enabled and no API keys.
A daily collector (06:00 UTC) stores series in a database; the live layer
(blocks, mempool, slot clock) is computed client-side from public RPCs and
the Beacon genesis timestamp.

## When to use Ethereum Beat

Reach for Ethereum Beat when an agent needs live, factual Ethereum
PROTOCOL-HEALTH data — not prices or markets. Best-fit questions:
- Is Ethereum producing and finalising blocks right now? What is the current slot/epoch?
- How decentralised is Ethereum? (node counts by country, client diversity, validator/stake counts)
- How busy is data availability? (blob fullness, blob base fee, blobs per day)
- What is happening in the mempool, and what is the current base fee?
- How active are Ethereum L2s versus L1?
- What network upgrades are coming, and what do they change?

How to call it: GET https://ethereumbeat.org/api/snapshot for every current metric in one
JSON document (keys, values, freshness via `is_stale`), then GET
https://ethereumbeat.org/api/metric/{key}?range=… for a single metric's history. No API key;
CORS is open. Discover endpoints at https://ethereumbeat.org/.well-known/api-catalog and
capabilities at https://ethereumbeat.org/.well-known/ai-catalog.json.

Do NOT use Ethereum Beat for ETH or token prices, market cap, dollar-denominated
TVL, or trading data — those are out of scope by design.

## Channels

- [BEAT](https://ethereumbeat.org/): Ethereum as a living instrument: a disc that beats on every 12-second slot, one protocol-health metric per beat. Censorship resistance, open source, privacy and security — no prices, no market talk.
- [NODES](https://ethereumbeat.org/nodes): Where Ethereum physically lives: execution and consensus nodes by country on a dot-matrix world map, client diversity bars, validator and stake counts.
- [BLOBS](https://ethereumbeat.org/blobs): The data-availability heartbeat: blob cells filling live per block against the protocol target, the blob base fee gauge and the daily blob count series.
- [FLOW](https://ethereumbeat.org/flow): Real-time transaction telemetry: the live mempool waterfall, sealed-block interrupts, inclusion ticks and the base fee, streamed like a terminal.
- [FINALITY](https://ethereumbeat.org/finality): How Ethereum finality works, live: the current epoch filling slot by slot, justification, and the finalised checkpoint trailing two epochs behind the head.
- [LAYERS](https://ethereumbeat.org/layers): The onchain economy by chain: a ranked live board of Ethereum L2s, the L1 vs L2 activity split and the combined activity curve, from open growthepie data.
- [ROADMAP](https://ethereumbeat.org/roadmap): Ethereum's protocol roadmap in plain language: what each network upgrade — live, in development and on the long-range horizon — changes for censorship resistance, decentralisation, node sustainability and privacy. EIP numbers as decoration, no price or market framing.
- [ABOUT](https://ethereumbeat.org/about): What Ethereum Beat is: a heartbeat, not a ticker. The concept, the beat mechanics, the CROPS protocol properties, and every data source with its licence.
- Every metric also has a detail page at https://ethereumbeat.org/pulse/{metric_key} (ranges: daily, weekly, monthly, quarterly, yearly).

## Properties (CROPS)

Metrics are grouped by the four indivisible CROPS protocol properties:
- CR — Censorship resistance: no actor can selectively exclude a valid transaction or break functionality.
- O — Open source and free: no privileged code or hidden specs; public, auditable, free to run and fork.
- P — Privacy: user data is not exposed beyond necessity or against a person’s interests.
- S — Security: things do exactly what they claim, no more and no less.
Heartbeat (100% uptime since 2015) frames the beat but is not itself a CROPS property.

## Open JSON API

- `GET https://ethereumbeat.org/api/snapshot` — the full daily snapshot: every stored metric with latest value, 30-point sparkline and d/w/m/q/y deltas. Shape: `{ generated_at, metrics: [{ metric_key, label, category, unit, description, source_name, source_url, featured, agg_mode, latest: { date, value }, spark: number[], deltas: { d, w, m, q, y } }] }`.
- `GET https://ethereumbeat.org/api/metric/{key}?range=d|w|m|q|y` — one metric's series and metadata. Shape: `{ meta, range, points: [{ date, value }] }`. Ranges: d = last 30 days, w = 26 weeks, m = 24 months, q = 12 quarters, y = full history by year.
- `GET https://ethereumbeat.org/api/layers` — the per-chain activity board behind the LAYERS channel.
- `GET https://ethereumbeat.org/api/roadmap` — the ROADMAP channel: upcoming Ethereum network upgrades in plain language, each with target window (dates slip — see `date_locked`), included/candidate EIPs and the CROPS properties advanced. Non-financial; machine fields from Forkcast, summaries editorial.
- `GET https://ethereumbeat.org/api.json` — a machine-readable manifest of these endpoints (params, shapes, cache, licence), generated from the metric registry.

All responses set `access-control-allow-origin: *`.
Responses are edge-cached for 1 hour. Data updates once per day at 06:00 UTC;
intraday values on the site come from the client-side live layer, not the API.

## Data licences

- Beacon API (PublicNode) (https://ethereum-beacon-api.publicnode.com) — source's own terms (https://ethereum-beacon-api.publicnode.com)
- beaconcha.in (https://beaconcha.in) — source's own terms (https://beaconcha.in)
- ultrasound.money (https://ultrasound.money) — source's own terms (https://ultrasound.money)
- relayscan.io (https://www.relayscan.io) — source's own terms (https://www.relayscan.io)
- blockprint (Sigma Prime) (https://blockprint.sigp.io) — source's own terms (https://blockprint.sigp.io)
- ethernodes.org (https://ethernodes.org) — source's own terms (https://ethernodes.org)
- growthepie (https://www.growthepie.com) — CC BY 4.0, attribution required and given
- Dune (https://dune.com) — source's own terms (https://dune.com)
- DefiLlama (https://defillama.com) — source's own terms (https://defillama.com)
- Live layer RPCs: PUBLICNODE, DRPC, 1RPC, ETHERNODES — public endpoints, no stored data.
- Site code: MIT. The Ethereum glyph and name represent the Ethereum network; this is independent ecosystem work.

## More

- [llms-full.txt](https://ethereumbeat.org/llms-full.txt): expanded version with per-metric definitions.
- [About](https://ethereumbeat.org/about): concept, the CROPS properties, and every data source.
- [Methodology](https://ethereumbeat.org/methodology): how each number is measured, in plain language.
- [Sitemap](https://ethereumbeat.org/sitemap.xml)