Data handling, as documented while the surface was liveHolder data comes from scheduled snapshots, warmed into a cache once a day. It is never a live stream. See what you can use today for every surface side by side.
What it does
Holder Wall is the ownership map and holder analytics surface of WalletWall. It displays the top holders of a selected token as a zoomable treemap, annotated with rank changes, wallet labels, and an interactive drawer for per-wallet detail.What you can learn
- How concentrated ownership is — how much of the total mapped value the top few entities hold.
- Who the holders are — the breakdown across whale, exchange, protocol, institution, and unclassified holders.
- What changed — rank changes against the previous snapshot, and which wallets are new to the tracked set this week.
- Which dormant wallets matter for migration planning — dormant entities and their mapped stablecoin balance.
- Where to look next — a wallet with dormancy or exposure data shows its Quantum Exposure Card, a wallet with an available graph can open Coinstellation, and a wallet with at least one vault-relevant signal can open a Stablecoin Vault readiness assessment.
How to read it
KPI strip
Numbers for the list you are viewing: distinct wallets listed across the ranked lists, the wallets and total in the active list, that list’s top-10 share, and the snapshot’s state and time next to the time your page loaded. Every share is of the wallets that list returned, never of total supply or of every holder.
Treemap
Zoomable tiles split across Active Wallets, Whale Wallets, and Dormant Quantum Wallets tabs. Each tab is sized by its own metric: 48-hour on-chain USD volume, large-trade USD volume, or an estimated proxy balance. A table view of the active list shows the same ranking without relying on tile size or colour.
Leaderboard
Top holders in rank order with labels, balances, and rank delta indicators.
Wallet drawer
Per-wallet detail — ENS, balance, timestamps, and the Quantum Exposure Card when dormancy or exposure data exists — opened from any tile or leaderboard row.
Signals panel
Below the KPI strip, a row of signal cards summarizes analytical readings for the holder set currently on screen. Each card shows a short label and a one-line summary:- Concentration — how much of the value listed in the active tab the top three wallets hold. It is computed inside that one list, over that list’s own metric, and states its denominator.
- Entity mix — the breakdown of holders across classifications (whale, exchange, protocol, institution, unclassified).
- Data freshness — whether the underlying scheduled data is current or may be stale, with the query run timestamps.
- Activity / value — whether the most valuable holders are also the most active, or the two diverge.
- Quantum exposure — dormant entities and their mapped stablecoin balance, the wallets most relevant to migration planning.
Treemap
Each tile in the treemap represents one wallet in a ranked top list. Tile area is proportional to that tab’s own metric as of the last scheduled run: 48-hour on-chain USD volume for Active Wallets, large-trade USD volume for Whale Wallets, and an estimated proxy balance for Dormant Quantum Wallets. Only the last is a balance estimate; the first two measure activity in a window, not what a wallet holds.- Active Wallets — wallets included in the 48-hour active wallet feed
- Whale Wallets — wallets included in the whale trades feed
- Dormant Quantum Wallets — wallets sourced from the dormant quantum candidates feed. Tile area uses a proxy USD balance estimate (not a live balance). A disclaimer banner renders above the treemap when this tab is active to flag the estimated nature of balance data.
vault, exposed, dormant, tracked, or estimated — plus a real transaction-count row. Smaller tiles fall back to a color-matched square marker so the signal stays legible at any tile size. estimated marks tiles whose USD area comes from a proxy balance estimate rather than a live balance.
Clicking a tile opens the wallet drawer for that address. It also enables navigation to Coinstellation for a full graph view of the wallet’s on-chain relationships.
Leaderboard and filters
The leaderboard panel lists the top holders in rank order with holder labels, balances, and rank delta indicators. The “New this week” marker appears on wallets that were not present in the previous snapshot. The filter bar allows narrowing by wallet category (whale, active, dormant) and by rank range.Wallet drawer
Clicking any tile or leaderboard row opens a slide-in drawer with per-wallet detail:- Resolved ENS name (when available)
- Balance and rank (shown as Proxy value for Dormant Quantum Wallet tiles, where balance is estimated)
- First seen / last active timestamps
- Link to open Coinstellation for this wallet
- Quantum Exposure Card, under the “Quantum Intelligence” heading
Fields shown for dormant quantum candidate tiles
Fields shown for dormant quantum candidate tiles
When the drawer opens for a tile sourced from the dormant quantum candidates feed, an additional detail section appears showing:
- Days since last outgoing transaction
- Outgoing transaction count
- Token symbols held
- Exposure type classification (e.g.
dormant,quantum_exposed)
What the Quantum Exposure Card shows
What the Quantum Exposure Card shows
- Composite Quantum Exposure Score (0–100)
- Risk band label: Low exposure / Moderate exposure / High exposure / Migration priority / Unknown
- Per-component breakdown: public key exposure, address reuse, signature scheme, value at risk, dormancy, migration readiness risk, recovery path risk
- Behavioral exposure signals (adversarial signals)
- Source caveats and confidence level
Stablecoin Vault handoff
When a valid EVM wallet with at least one vault-relevant signal is open in the wallet drawer (any tab), the drawer can route to the Stablecoin Vault readiness assessment at/stablecoin-vault. It carries the wallet address and any known values as a prefill you can review and adjust. When the evidence is partial, the link reads “Vault: partial evidence”.
Data freshness and provenance
Holder Wall is one of the surfaces that remains on scheduled Dune snapshots, warmed into a cache once a day. All Dune data is labeledScheduled/Cached in the UI, and the KPI strip shows when the query last ran. See Data Serving Architecture for how that class of data differs from live wallet reads and from WalletWall-owned BigQuery snapshots.
Important boundaries
- Some balances are estimates. Dormant Quantum Wallet tiles use a proxy USD balance, not a live balance, and the tab and drawer say so.
- “New this week” describes the tracked set. It reflects wallets that entered the tracked set since the last snapshot, not wallets that created their Ethereum account this week.
- Rank changes need a previous snapshot. Without the snapshot store, rank delta badges are omitted and the “New this week” count is unavailable.
- The Stablecoin Vault handoff is read-only. No wallet connection, signing, or transaction is required. The entry surfaces only for valid EVM wallets with at least one vault-relevant signal. A proxy-balance estimate can arrive as the prefilled balance, so review prefilled values before evaluating.
Technical reference
Data flow
Rank delta badges and the “New this week” marker require the Redis snapshot store; without it, both are omitted. All Dune data is scheduled/cached, never live.Implementation notes
Rank snapshots
Rank snapshots
Rank deltas require the Redis-backed snapshot store to be configured. The rank snapshot is written to Redis on each successful Dune result fetch and compared on the next fetch. Rank delta is a derived field — it is not stored in Dune. “New this week” is derived from the same store.
API and client behavior
API and client behavior
- The KPI strip reads from the
metadatablock of the/api/holder-wallresponse, and thequeryRunAttimestamp is the run time it shows. - Filters operate client-side against the current Dune result set.
- The dormant quantum candidates feed is a 13-column Dune query.
- The Quantum Exposure Card renders only behavioral signals with
score >= 0.3.
Signal rendering
Signal rendering
Signal colors reuse the shared
Badge tone washes (translucent background + thin border), so a signal means the same color here as everywhere else in the app. The detail renders directly on the SVG treemap.The Quantum exposure card’s reconciliation prevents an earlier mismatch where the signal could reference dormant wallets while the treemap was still showing a different tab or a filtered subset.Related pages
Whale Watcher
Large stablecoin and treasury-like wallet monitoring — activity heatmap, adversarial signals, and narrative engine.
Quantum Intelligence
The full Quantum Exposure Score specification, migration path table, and approved framing behind the drawer’s card.
Coinstellation
The wallet relationship graph a tile or leaderboard row links out to.
Stablecoin Vault & Vault Simulator
The read-only readiness assessment the wallet drawer can hand off to for a valid EVM wallet with at least one vault-relevant signal.

