Smart Money Rotation Radar

smrr is a small CLI that separates fresh smart-money rotation from structural holdings.

What problem it solves

Many "smart money is buying" takes confuse 30d+ holdings with fresh rotation. smrr separates them automatically and pushes obvious false positives into a guard list.

Install

python3 -m pip install -r smrr/requirements.txt

Optional:

• Install the official Nansen CLI and make it available on PATH
• Export NANSEN_API_KEY or keep it in ~/.crypto-intel.env
• Set SMRR_SYMBOL_REGISTRY when using smrr outside this repo

Usage

python3 -m smrr scan --seed top-tokens --profile balanced --output /tmp/smrr_report.md
python3 -m smrr report
python3 -m smrr explain SOL
python3 -m smrr version

How it uses Nansen

Current fresh-run call budget with N=5 tokens:

• 1 call: seed universe in top-tokens mode
• 5 calls: token_flows(24h)
• 5 calls: token_flows(7d)
• 5 calls: token_who_bought_sold(24h)
• 5 calls: token_who_bought_sold(7d)
• 5 calls: smart_money_balances
• 10 calls: token_info + token_indicators
• 5 calls: wallet_pnl(top holder)

Total fresh-run budget:

• 41 calls in top-tokens mode
• 40 calls with an explicit 5-token seed

smrr reports both the fresh-run budget and the live calls used in the current run, so cached runs do not overclaim call usage.

Breadth scoring uses a fixed reference of 10 wallets for demo readability:

• 2 wallets -> 20
• 5 wallets -> 50
• 10+ wallets -> 100

Breadth is capped by the query limit:

• who-bought-sold is queried with --limit 20
• tokens with 20+ buyers are indistinguishable by breadth score alone

Absolute inflow floors are profile-based:

• conservative: $100k
• balanced: $25k
• aggressive: $10k

This keeps the floor explainable in demos without pretending one threshold fits every token size.

If the CLI is unavailable, smrr falls back to REST for the endpoints it knows how to call and then to the local symbol registry for seed resolution.

Environment overrides

• SMRR_STATE_DIR: override local state/cache directory
• SMRR_SYMBOL_REGISTRY: point to a symbol_registry.json outside this repo

Not a buy signal

smrr is a research prioritization tool, not financial advice.