​

Holder Wall

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 deltas, wallet labels, and an interactive drawer for per-wallet detail. Data is powered by Dune Analytics scheduled queries. It is never live streaming.

​

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.

​

KPI strip

A strip at the top of the page surfaces aggregate metrics for the current token: total holders tracked, number of wallets new this week, and the timestamp of the most recent Dune query run. The KPI strip reads from the metadata block of the /api/holder-wall response.

​

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 total mapped value the top few entities hold.
• Entity mix — the breakdown of holders across classifications (whale, exchange, protocol, institution, unclassified).
• Data freshness — whether the underlying Dune 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.

The signals are derived from the treemap that is currently displayed, so they respect the active tab and any filters — narrowing the wall re-computes the cards against the visible subset rather than the whole token.

​

Signal click

Clicking a signal card opens a drawer with the full breakdown behind that reading — the headline figure plus the ranked entities that drive it. The Quantum exposure card additionally reconciles the wall with the signal: selecting it switches the treemap to the Dormant Quantum Wallets tab and clears active filters, so the holders shown below are exactly the dormant entities the card is describing. This prevents the earlier mismatch where the signal could reference dormant wallets while the treemap was still showing a different tab or a filtered subset.

​

Treemap layout

Each tile in the treemap represents one holder. Tile area is proportional to the wallet’s balance in USD at the time of the last Dune run.

​

Tabs

• 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 Dune query. 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.

​

Rank badges

Each tile carries a rank badge showing absolute rank (1, 2, 3 …) and a delta indicator comparing the wallet’s rank in the current snapshot to the previous Redis snapshot. 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.

​

Tile detail and signals

Large tiles carry a labelled signal pill — one of 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. 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 live SVG treemap; estimated marks tiles whose USD area comes from a proxy balance estimate rather than a live balance.

​

Tile click

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

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 Redis snapshot.

​

Filters

The filter bar allows narrowing by wallet category (whale, active, dormant) and by rank range. Filters operate client-side against the current Dune result set.

​

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 (see below)

​

Dormant Quantum Candidate detail

​

Quantum Exposure Card in the drawer

The Quantum Exposure Card renders inside the drawer under the “Quantum Intelligence” heading.

​

Stablecoin Vault handoff

When a valid EVM wallet is open in the wallet drawer (any tab), the drawer can route to the Stablecoin Vault readiness assessment at /stablecoin-vault with the wallet address in context. This handoff was added in PR #1003. It applies to wallets where a recognizable EVM address is present. The readiness route is read-only — no wallet connection, signing, or transaction is required.

​

Data source aliases

All Dune data is labeled Scheduled/Cached in the UI. The queryRunAt timestamp is shown in the KPI strip.

​

Related