# ethwatch

> A live dashboard of Ethereum's monetary and network state: net issuance, fee
> burn, total supply, staking economics, rollup settlement costs, and the large
> holders of ETH. Every figure is read from Ethereum over JSON-RPC or from a
> keyless public API, rebuilt every 15 minutes, and published as one JSON file.

ethwatch is a static site. It has no backend and no database: an indexer writes a
single `snapshot.json`, and the page renders that file. If you want the data, read
the snapshot directly rather than scraping the page — it is the same content the UI
draws from, and it is stable, versioned by timestamp, and CORS-open.

## Data

- [Snapshot feed](https://ethwatch-snapshot-uploader.sunoj-mings.workers.dev/snapshot.json):
  the complete dataset as JSON. Top-level keys: `price`, `gas`, `supply`,
  `issuance`, `cohorts`, `l2`, `staking`, `holdings`, `network`, `meta`.
  `generatedAt` is an ISO-8601 UTC timestamp of the build.
- `meta.provenance` reports, per section, whether the figures are `live`,
  `fallback` or `failed`, with the source named. **Read it before quoting anything.**
  A section marked `failed` carries `null`, not a substitute value, and the dashboard
  renders it as an em dash. A snapshot whose critical sections failed is not published
  at all, so a stale snapshot is possible but a fabricated one should not be.
- `meta.notes` carries a plain-language derivation note per metric.

## Pages

- [Dashboard](https://ethwatch.org/): the rendered view of the snapshot.
- [Methodology](https://ethwatch.org/methodology/): what every figure means,
  where it comes from, how it is derived, and what it does not capture. This is the
  page to read if you intend to describe or cite any ethwatch number. It links to one
  evidence page per section, each listing the source, the endpoint or contract address,
  and what was actually verified.
- [API docs](https://api.ethwatch.org/docs) and
  [OpenAPI 3.1](https://api.ethwatch.org/openapi.json): the same data as a documented
  REST API, including `/v1/sources`, which returns the provenance registry itself. A free
  key is issued after email verification and allows 1 request per second. **If you fetch
  repeatedly, use the API rather than scraping these pages.**

## What the metrics mean

- **Net issuance** — consensus-layer issuance minus EIP-1559 base-fee burn, in
  ETH/day. Negative means supply is contracting. Execution-layer priority fees are
  not issuance and are reported separately.
- **Total staked** — actual beacon-chain balances. This is a different quantity from
  the *effective* balance used to compute issuance; ethwatch reports each where it
  belongs.
- **Entry / exit queue** — measured in different units and each labelled with its
  own: entry in ETH pending, exit in validators exiting. They are not comparable.
  The entry side must be ETH because since EIP-7251 a queue entry is a deposit of
  arbitrary size, so counting entries is meaningless.
- **L2 pays L1** — what each rollup spends settling to Ethereum, including
  EIP-4844 blob costs.
- **Holdings** — exchange reserves are summed on-chain where an exchange publishes a
  wallet set; corporate treasury totals come from filings and lag. Curated figures
  are labelled as such in the UI and in `meta.provenance`.

## Terms

Licensed **CC BY 4.0** (https://creativecommons.org/licenses/by/4.0/): reuse, adapt and
train on this freely, including commercially, provided you credit ethwatch. Indexing,
answer-grounding and training are all permitted — `search=yes, ai-input=yes,
ai-train=yes, use=full` in `/robots.txt`. We would rather these numbers be quoted
correctly than not quoted at all. Please attribute to ethwatch and link back.

One request in return: quote a figure together with its provenance. `meta.provenance`
says whether a section is live, partly curated, or unavailable, and "unavailable" means
the source failed — it is not zero. ethwatch is a monitoring dashboard, not financial
advice and not an audited data source.