base-alpha-scanner

# Base Alpha Scanner ZHAO's on-chain intelligence toolkit for Base chain. Data-first, no hype. Alert only on high-conviction setups. ## Scripts ### scan_base.py — Core on-chain scanner ``` python3 skills/base-alpha-scanner/scripts/scan_base.py --mode <mode> [addr] ``` Modes: - `trending` — Top Base tokens ranked by conviction score (1h) - `new` — Early launch scanner: 0–45min + 45min–3h windows - `token <addr>` — Deep dive on specific token (all timeframes) - `holders <addr>` — Holder distribution + concentration check - `gmgn <addr>` — GMGN smart money data (may need browser fallback) ### scan_narrative.py — Narrative & platform scanner ``` python3 skills/base-alpha-scanner/scripts/scan_narrative.py --mode <mode> ``` Modes: - `clanker` — Latest Clanker token deployments on Base - `bankr` — Bankr.fun trending tokens (Farcaster-native) - `virtual` — VIRTUAL Protocol AI agent ecosystem - `ai` — Broad AI narrative scan across Base ## Workflow ### Standard market scan (run on demand or every 1–2h): 1. `scan_base.py --mode trending` → identify what's moving 2. For anything score ≥ 60: `scan_base.py --mode token <addr>` → deep dive 3. If AI narrative or Farcaster signals: `scan_narrative.py --mode ai` + `clanker` 4. Apply alert rules → ping ZHAO only if threshold met ### Early launch scan (continuous background): 1. `scan_base.py --mode new` → check 0–45min window 2. Score ≥ 60 + clean signals → immediate check with `token` mode 3. Cross-reference with `scan_narrative.py --mode clanker` for Farcaster origin 4. If all checks pass → early gem ping ### Holder distribution check: 1. `scan_base.py --mode holders <addr>` 2. Flag if top-5 > 40% supply or any single wallet > 15% 3. Cross with DexScreener buy/sell maker count to confirm real distribution ## Alert Rules Read `references/alert-rules.md` for full ruleset. Summary: - **Immediate ping**: Tier 1 only (vol spike + narrative + clean chart + liq > $100K) - **Second-wave alert**: 45min–3h old, sustained vol + holder growth, score ≥ 65 - **Early gem**: <45min, score ≥ 60, clean team, real momentum. Max 2–3/day - **Mainstream (BTC/ETH/UNI)**: Key level breaks, on-chain flows, funding extremes ## API Reference See `references/api-endpoints.md` for all endpoints, field names, and data source details. Key addresses: - VIRTUAL token (Base): `0x0b3e328455c4059EEb9e3f84b5543F74E24e7E1b` - cbBTC (Base): `0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf` ## Conviction Score (0–100) Built into `scan_base.py`. Score ≥ 65 = alert candidate. Score < 50 = ignore. Factors: 1h volume, liquidity, buy pressure ratio, age (45min–3h = peak), momentum, mcap. ## GMGN Notes GMGN often blocks direct API access. Fallback options: 1. Use `browser` tool to navigate `https://gmgn.ai/base/token/<addr>` 2. Take screenshot for ZHAO if needed 3. Check wallet history at `https://gmgn.ai/base/address/<wallet>` ## Bankr Notes No clean public API. Bankr alpha comes from Warpcast: - Channel: `https://warpcast.com/~/channel/bankr` - Use `web_search` for recent Bankr mentions + `web_fetch` on Warpcast casts - High signal: power users (>5K followers) buying via Bankr frame in <30min of launch