# 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.

## Metrics

Every stored metric, from the metric registry (metric_meta). `featured`
metrics rotate on the BEAT channel; everything is queryable via the API.

### Heartbeat

- `uptime_days` — Days of uptime (unit: days; aggregation: last; featured)
  Continuous days since genesis on 30 July 2015. Ethereum has never stopped producing blocks.
  CROPS: Heartbeat · Source: computed from genesis <https://ethereum.org/en/history/> · Licence: https://ethereum.org/en/history/ · API: https://ethereumbeat.org/api/metric/uptime_days
- `finality_ok` — Chain finalising (unit: epoch; aggregation: last; featured)
  The last finalised epoch. Finality means the chain's history is locked in and cannot be rewritten.
  CROPS: Heartbeat · Source: Beacon API (PublicNode) <https://ethereum-beacon-api.publicnode.com> · Licence: https://ethereum-beacon-api.publicnode.com · API: https://ethereumbeat.org/api/metric/finality_ok
- `participation_rate` — Sync participation (unit: pct; aggregation: last; featured)
  Share of the sync committee signing off on the latest block. Near 100% means validators are present and agreeing.
  CROPS: Heartbeat · Source: Beacon API (PublicNode) <https://ethereum-beacon-api.publicnode.com> · Licence: https://ethereum-beacon-api.publicnode.com · API: https://ethereumbeat.org/api/metric/participation_rate

### Censorship resistance

- `validators_active` — Active validators (unit: count; aggregation: last; featured)
  Independent validators currently securing the chain. More validators means no small group can block transactions.
  CROPS: Censorship resistance · Source: beaconcha.in <https://beaconcha.in> · Licence: https://beaconcha.in · API: https://ethereumbeat.org/api/metric/validators_active
- `staked_eth` — ETH staked (unit: eth; aggregation: last; featured)
  Total ETH locked by validators as collateral for honest behaviour, shown with the share of all ETH.
  CROPS: Censorship resistance · Source: ultrasound.money <https://ultrasound.money> · Licence: https://ultrasound.money · API: https://ethereumbeat.org/api/metric/staked_eth
- `staked_pct` — Share of ETH staked (unit: pct; aggregation: last)
  The percentage of all ETH that is staked to secure the network.
  CROPS: Censorship resistance · Source: ultrasound.money <https://ultrasound.money> · Licence: https://ultrasound.money · API: https://ethereumbeat.org/api/metric/staked_pct
- `validator_queue_entry` — Validators joining (unit: count; aggregation: last)
  Validators waiting in the entry queue. A long queue means more people want to help secure Ethereum than it admits per day.
  CROPS: Censorship resistance · Source: beaconcha.in <https://beaconcha.in> · Licence: https://beaconcha.in · API: https://ethereumbeat.org/api/metric/validator_queue_entry
- `validator_queue_exit` — Validators leaving (unit: count; aggregation: last)
  Validators waiting to exit. Ethereum rate-limits both doors so the validator set changes slowly and safely.
  CROPS: Censorship resistance · Source: beaconcha.in <https://beaconcha.in> · Licence: https://beaconcha.in · API: https://ethereumbeat.org/api/metric/validator_queue_exit
- `builder_share` — Top builder share (unit: pct; aggregation: mean)
  Share of blocks built by the largest block builder. Lower concentration makes censorship harder.
  CROPS: Censorship resistance · Source: relayscan.io <https://www.relayscan.io> · Licence: https://www.relayscan.io · API: https://ethereumbeat.org/api/metric/builder_share
- `node_countries` — Countries running nodes (unit: count; aggregation: last)
  Countries where Ethereum nodes run. Geographic spread means no government can switch Ethereum off.
  CROPS: Censorship resistance · Source: ethernodes.org <https://ethernodes.org> · Licence: https://ethernodes.org · API: https://ethereumbeat.org/api/metric/node_countries

### Open source & free

- `client_diversity_cl` — Largest consensus client (unit: pct; aggregation: last)
  Share of the biggest consensus client. Below one third, a single client bug cannot break finality.
  CROPS: Open source & free · Source: blockprint (Sigma Prime) <https://blockprint.sigp.io> · Licence: https://blockprint.sigp.io · API: https://ethereumbeat.org/api/metric/client_diversity_cl
- `client_diversity_el` — Largest execution client (unit: pct; aggregation: last)
  Share of the biggest execution client. Diversity keeps one bug from becoming everyone's bug.
  CROPS: Open source & free · Source: ethernodes.org <https://ethernodes.org> · Licence: https://ethernodes.org · API: https://ethereumbeat.org/api/metric/client_diversity_el
- `daa_combined` — Daily active addresses (unit: count; aggregation: sum; featured)
  Unique addresses active today across Ethereum and its layer 2 networks.
  CROPS: Open source & free · Source: growthepie <https://www.growthepie.com> · Licence: https://creativecommons.org/licenses/by/4.0/ · API: https://ethereumbeat.org/api/metric/daa_combined
- `txcount_combined` — Daily transactions (unit: count; aggregation: sum; featured)
  Transactions settled today across Ethereum and its layer 2 networks.
  CROPS: Open source & free · Source: growthepie <https://www.growthepie.com> · Licence: https://creativecommons.org/licenses/by/4.0/ · API: https://ethereumbeat.org/api/metric/txcount_combined
- `throughput` — Throughput (unit: mgas_s; aggregation: mean; featured)
  Combined computation processed per second across Ethereum and its layer 2 networks, measured in gas.
  CROPS: Open source & free · Source: growthepie <https://www.growthepie.com> · Licence: https://creativecommons.org/licenses/by/4.0/ · API: https://ethereumbeat.org/api/metric/throughput
- `blobs_daily` — Blobs per day (unit: count; aggregation: sum)
  Data blobs posted to Ethereum each day. Blobs are how layer 2 networks land their data on Ethereum.
  CROPS: Open source & free · Source: growthepie <https://www.growthepie.com> · Licence: https://creativecommons.org/licenses/by/4.0/ · API: https://ethereumbeat.org/api/metric/blobs_daily
- `blobs_per_block_avg` — Blobs per block (unit: count; aggregation: mean)
  Average blobs carried per block today, against a protocol target of 14.
  CROPS: Open source & free · Source: growthepie <https://www.growthepie.com> · Licence: https://creativecommons.org/licenses/by/4.0/ · API: https://ethereumbeat.org/api/metric/blobs_per_block_avg
- `blob_chains` — Chains posting blobs (unit: count; aggregation: last)
  Distinct chains that posted blob data to Ethereum today.
  CROPS: Open source & free · Source: growthepie <https://www.growthepie.com> · Licence: https://creativecommons.org/licenses/by/4.0/ · API: https://ethereumbeat.org/api/metric/blob_chains
- `median_l2_fee` — Median layer 2 fee (unit: usd_small; aggregation: mean)
  The typical cost of a transaction on Ethereum's layer 2 networks. Affordability is what makes openness real.
  CROPS: Open source & free · Source: growthepie <https://www.growthepie.com> · Licence: https://creativecommons.org/licenses/by/4.0/ · API: https://ethereumbeat.org/api/metric/median_l2_fee
- `l2_count` — Live layer 2 networks (unit: count; aggregation: last)
  Layer 2 networks live on Ethereum and tracked by growthepie.
  CROPS: Open source & free · Source: growthepie <https://www.growthepie.com> · Licence: https://creativecommons.org/licenses/by/4.0/ · API: https://ethereumbeat.org/api/metric/l2_count
- `contracts_deployed` — New contracts per day (unit: count; aggregation: sum)
  Smart contracts deployed on Ethereum today. Every one is a small act of permissionless building.
  CROPS: Open source & free · Source: Dune <https://dune.com> · Licence: https://dune.com · API: https://ethereumbeat.org/api/metric/contracts_deployed

### Security

- `stables_supply` — Stablecoin supply (unit: usd; aggregation: last)
  Value of stablecoins issued on Ethereum and its layer 2 networks. Everyday money settling on neutral rails.
  CROPS: Security · Source: growthepie <https://www.growthepie.com> · Licence: https://creativecommons.org/licenses/by/4.0/ · API: https://ethereumbeat.org/api/metric/stables_supply
- `rwa_value` — Real-world assets (unit: usd; aggregation: last; featured)
  Value of tokenised real-world assets, such as treasury bills and bonds, secured by Ethereum.
  CROPS: Security · Source: DefiLlama <https://defillama.com> · Licence: https://defillama.com · API: https://ethereumbeat.org/api/metric/rwa_value
- `tvs` — Total value secured (unit: usd; aggregation: last; featured)
  Total value locked in applications that trust Ethereum and its layer 2 networks for security.
  CROPS: Security · Source: growthepie <https://www.growthepie.com> · Licence: https://creativecommons.org/licenses/by/4.0/ · API: https://ethereumbeat.org/api/metric/tvs