How It Works

Multi-chain divergence scanner with volume proxy analysis and Wyckoff phase classification

Wyckoff Phases

PhaseSM FlowPriceSignal
ACCUMULATIONBuyingFallingBullish divergence — SM buying the dip
DISTRIBUTIONSellingRisingBearish divergence — SM exiting into strength
MARKUPBuyingRisingTrend confirmed — momentum aligned
MARKDOWNSellingFallingCapitulation — both SM and price declining

Features

Alpha Score

Each token gets an Alpha Score (0-100) based on four weighted factors: flow magnitude (40%), price movement (25%), wallet diversity (20%), and holdings conviction (15%). Scores use log-scaled normalization to prevent large-cap tokens from dominating.

Data Pipeline

1.MCP DiscoveryToken search across 8 chains via Nansen MCP (0 credits)
2.CLI EnrichmentReal SM data via token screener + smart-money netflow (~12 credits/cycle)
3.Price HistorySQLite-tracked price snapshots for real change computation
4.Volume ProxyVol/MCap ratio + relative volume → activity classification
5.Divergence EnginePrice-volume divergence → Wyckoff phase + confidence
6.Signal HistoryOutcome tracking + backtesting against price changes

Hybrid Pipeline: CLI + Volume Proxy

Top tokens on Ethereum and BNB Chain are enriched with real smart money data from the Nansen CLI (research token screener + research smart-money netflow). Remaining tokens use volume proxy analysis. Tokens with CLI data are marked with a greenCLI badge; volume-proxy tokens show a gray VP badge.

CLI CommandDataCredits
research token screenerReal price, market cap, market netflow1/page
research smart-money netflowReal SM net flow per token (24h/7d)5/page

Enrichment runs every 30 minutes, consuming ~12 credits per cycle (~288/day). Configurable viaCLI_ENRICH_CHAINS and CLI_ENRICH_MINUTES env vars.

Volume Proxy Methodology

Instead of requiring premium smart money wallet data, the scanner derives institutional activity signals from publicly available volume and price data:

MetricFormulaWhat It Detects
Vol/MCap Ratiovolume_24h / market_capUnusual trading activity relative to token size
Relative Volumecurrent_vol / avg_vol_72hVolume spikes vs recent baseline
Price-Vol Divergencehigh_volume + falling_priceAccumulation (buying into weakness)
Whale Count Est.volume / avg_institutional_tradeEstimated number of large transactions

Try It Yourself

Install the Nansen CLI and run these commands to see the raw data this scanner uses:

# Install Nansen CLI
npm i -g nansen-cli && nansen login
# Token screener — top tokens by volume (1 credit)
nansen research token screener --chain ethereum --timeframe 24h
# Smart money net flow — where SM wallets are moving (5 credits)
nansen research smart-money netflow --chain ethereum
# SM dex trades — individual whale trades (5 credits)
nansen research smart-money dex-trades --chain bnb
# Token deep dive — flow intelligence + Nansen Score (5 credits)
nansen research token flow-intelligence --chain ethereum --token 0x...
# Wallet profiler — who is this wallet? (1 credit)
nansen research profiler labels --address 0x... --chain ethereum

All 9 Nansen CLI endpoints are integrated. The scanner runs token screener +smart-money netflow every 30 minutes for ETH/BNB enrichment, plusflow-intelligence, who-bought-sold, andtoken indicators for top token deep dives.

Coverage

Scans 8 blockchains (Ethereum, BNB, Solana, Base, Arbitrum, Polygon, Optimism, Avalanche) via Nansen MCP discovery at zero credit cost. Auto-refreshed every 5 minutes. Signal outcomes tracked in SQLite and validated against subsequent price movements for backtesting.