# Map of Ethereum

[Open the map](https://map-of-ethereum.zqnm.chatgpt.site/) · [Methodology](/data-quality)

Explore the saved Ethereum capital inventory, underlying assets, protocol locations and editorial decentralization ratings. Coverage is selected, not all Ethereum wealth or aggregate DeFi TVL. ETH wallets are residual estimates. Tokenized Bitcoin and selected utility tokens cover measured reserves, not full supply.

## Navigate

Languages: `/` (English), `/es`, `/pt` (Brazilian Portuguese), `/fr`, `/de`, `/zh` (Simplified Chinese), `/ja`, `/ko`. Each has a methodology route, for example `/es/data-quality`. A bare root visit restores the device’s remembered locale. Explicit locale paths, shared view queries and `?lang=en` override that preference.

- `?item=base` selects Base L2. Use IDs from the snapshot, not tickers.
- `?panel=directory&q=USDC` opens the searchable directory.
- `?density=1` through `?density=5` sets label density from sparse landmarks to detailed labels. Legacy `?labels=1` restores level5.
- `x`, `y`, `z` preserve the settled view: normalized center coordinates and zoom relative to the fixed overview bounds. The interface produces valid camera links. Malformed state is ignored safely.
- Copy, bookmark, refresh, and Back/Forward retain the view. Ordinary entity links support new tabs.
- Keyboard: arrows pan, + / − zoom, Home fits. Every entity is available through the directory. The map intentionally uses a dark-only palette.

## Read data

- [Normalized price and contract-balance evidence](/api/observations)
- [Latest saved JSON](/api/map)
- [Latest saved Protocol Buffers](/api/capital)
- [Bundled JSON](/data/capital.json)
- [Bundled Protocol Buffers](/data/capital.pb)
- [Schema](/data/capital.proto)
- [D-rating evidence registry](/data/control-registry.json)

Money is USD. Observation times are UTC. `observedAt` and per-position observation times describe the source, while `builtAt` describes assembly. Some publishers provide no observation time. The control registry has its own review date. A successful request does not imply fresh financial observations or a renewed control review.

Only monetary chips add capital. Platforms and L2 boards are subsets, not additional wealth. Large chips represent 100 small chips; each position retains its fractional remainder. Staking subtracts tracked liquid-staking backing once. Unknown composition remains unknown. Do not add contextual reported TVL to the inventory.

D ratings describe documented on-chain powers, not wallet custody, probabilities of loss or independent audits. Native ETH wallets and staking are D0; dependencies compose by their highest rating, retaining useful lower bounds for unreviewed dependencies. Read the dated registry before interpreting a rating.

A scheduled daily task progresses collection through a shared source lease, at least one minute between upstream requests and one cycle per UTC day. Visits can also advance due work. Failed or rate-limited sources retain their last good observation. The refresh control reads saved data; it cannot bypass provider cooldowns. Do not poll aggressively.

Image exports are data visualizations. They use a fixed dark artwork palette. No wallet connection or transaction action is provided.

## Net flows

GET `/api/flows` returns `{schemaVersion:1, observations:[{place,netUsd,from,to,source,assets,method}]}`. `from` and `to` are Unix milliseconds. `method` is `quantity-change`: covered token quantities compared across a 23–25-hour window and valued at ending prices. These are estimates, not transaction-based accounting, and can include yield, rebases or source reclassification. Zero is distinct from unavailable. The interface hides windows older than 36 hours and future-dated observations. Do not sum protocol flows into L2 flows.

The optional URL parameter `flows=0` hides the layer. Layer state is shared and restored alongside selection, labels and camera state.
