Skip to main content

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.

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.

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

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.
Rank deltas require the Redis-backed snapshot store to be configured. Without it, delta badges are omitted and the “New this week” count is unavailable.
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 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.
“New this week” is a Redis-derived signal. It reflects wallets that entered the tracked set since the last snapshot write, not wallets that created their Ethereum account this week.

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
  • First seen / last active timestamps
  • Link to open Coinstellation for this wallet
  • Quantum Exposure Card (see below)

Quantum Exposure Card in the drawer

The QuantumExposureCard component renders inside the drawer under the “Quantum Intelligence” heading. It 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) — only signals with score >= 0.3 are rendered
  • Source caveats and confidence level
A high Quantum Exposure Score does not mean the wallet is currently exploitable. It is a forward-looking heuristic for cryptographic migration planning. See the Quantum Intelligence feature page for full framing.

Data source aliases

Public aliasUsed for
Active wallet feedActive Wallets tab — 48-hour active wallet feed
Whale trade feedWhale Wallets tab — whale trade feed
Dormancy exposure feedDormancy-weighted quantum exposure signals (optional)
Redis snapshot storeRank delta snapshots and “New this week” detection
All Dune data is labeled Scheduled/Cached in the UI. The queryRunAt timestamp is shown in the KPI strip.