Documentation

Get the most out of DegenZone

A real-time treemap of DEX markets with smart-money overlay, narrative rotation, and pump detection. Everything you need to know in one page.

Overview#

DegenZone visualises decentralised exchange activity as a single treemap. Every tile is one token. Tile size reflects trading volume (or liquidity, or market cap — your choice). Tile color reflects the price change over the selected timeframe. The view refreshes every fifteen seconds.

Four chains are live: Solana, Base, BSC, and Ethereum. Switch with the chain tabs at the top of the app, or press 14 while focused.

How tiles are sized and colored#

  • Size axis — choose Volume, Liquidity, or Market Cap from the filter bar. Volume is the default and rewards the most-traded tokens with bigger tiles.
  • Color — a 15-stop diverging scale from deep red (sharp negative) through dark grey (flat) to deep green (sharp positive). Saturates at ±50% so an outlier doesn't flatten the rest of the map.
  • Intensity halo — tiles with |%change| over 25% get a subtle green or red outline. Quick spotting of extreme moves.
  • Star border — tokens in your watchlist (or held in the wallet overlay) have a gold border.
Hover any tile for a tooltip with price, market cap, liquidity, 24h volume, and age. Click a tile to open the detail panel with sparkline, action buttons, and full stats.

Filters#

  • Time — 5m, 1h, 6h, 24h. Changes both the price-change color and the volume metric used for sizing.
  • Size — Volume / Liquidity / M.Cap as discussed above.
  • View — flat token grid or sector-grouped (see Narrative sectors below).
  • Min Liq — drop tokens with liquidity below the threshold. Useful to filter out thin / honeypot tokens.

Tokens that are obviously not memecoins or altcoins (stablecoins, wrapped majors, LSTs, RWA tokens like XAUt/PAXG) are excluded by default. The heatmap is built for tokens that actually move.

Signals#

Smart Money

A cyan border + dot indicates a tracked whale wallet has bought the token in the last hour. We watch ten Solana wallets (configurable via the SMART_WALLETS_JSON environment variable). Signal comes from real on-chain RPC polling — pre-token-balance vs post-token-balance diff per transaction.

Pump

Yellow pulsing border indicates an active pump signal. Composite of four sub-scores: volume z-score, buyer velocity ratio, price acceleration, and buy-share. Tile must pass all four thresholds simultaneously.

Whale

Gold border indicates abnormally large average trade size in the last hour combined with positive 1h price change. Catches institutional / sniper accumulation in real time.

Fresh

When toggled, the view is restricted to tokens with pool age under 48 hours. Filter thresholds (max % change, min volume) are loosened since fresh tokens are inherently more volatile.

Narrative sectors#

Switch the View filter from Tokens to Sectors to see a two-level treemap. Parent tiles group tokens by narrative — dog memes, cat memes, AI agents, Trump-tied, food memes, DeFi, etc. Useful to spot capital rotation: when AI tiles shrink and dog tiles grow, money is flowing.

Categorisation is curated in lib/narratives.ts by symbol match and fallback patterns. Tokens not in any sector land in "Other".

Time Machine#

The Time Machine button in the filter bar (or T) opens a side panel comparing the current heatmap to a snapshot from 15 minutes, 1 hour, or 4 hours ago. Surfaces:

  • Number of tokens that entered the top-150 since then.
  • Number that dropped out.
  • Biggest price movers (absolute %change since the snapshot).
  • List of brand-new entries — typically pump.fun graduates that just crossed the volume threshold.

Snapshots are recorded every 60 seconds and persisted to disk so they survive process restarts. Retention is 4 hours by default.

Wallet portfolio overlay#

The Wallet button (or click the wallet icon in the filter bar) opens a panel where you can paste any Solana wallet address. We query Solana RPC getTokenAccountsByOwner for real on-chain holdings, cross-reference with our price cache, and overlay the positions on the heatmap with a star border.

The panel shows portfolio value, 24h P&L, and per-token balance with current price / change. Tokens outside the top-150 view are listed as "unpriced".

Watchlist#

Click the star icon in any side panel to add a token to your watchlist. Watchlist is stored in localStorage on your device (no account required).

Toggle the Watchlist button in the filter bar to view only your watched tokens. The count badge shows how many tokens are watched.

Keyboard shortcuts#

KeyAction
⌘K / Ctrl+K / /Focus search
1 / 2 / 3 / 4Switch timeframe (5m / 1h / 6h / 24h)
SCycle size axis (Volume → Liquidity → M.Cap)
GToggle Sector / Token view
MToggle Smart Money overlay
PToggle Pump-mode
FToggle Fresh-mode
WToggle Whale-mode
TOpen Time Machine panel
ESCClose panel / clear search