ghost-alpha

# Ghost Alpha — Wallet Clustering & Smart Money Tracking Track smart wallets, find alpha when wallet clusters converge on new tokens. ## Wallet Tracking ``` /alpha track <wallet> [--label name] Add wallet to tracking /alpha untrack <wallet> Remove wallet /alpha wallets List tracked wallets /alpha wallet <wallet> Wallet details + recent trades ``` ## Cluster Discovery ``` /alpha clusters Show top wallet clusters /alpha cluster <id> Cluster details /alpha score <mint> How many smart wallets hold this token ``` ## Alerts ``` /alpha alerts [--limit N] Recent convergence alerts /alpha live Start real-time cluster monitoring ``` ## Service Control ``` /alpha start Start background scanning /alpha stop Stop scanning /alpha stats Service status + stats /alpha config [key] [value] View/update config ``` ## How Clustering Works 1. **Track wallets** — add smart money wallets you want to monitor 2. **Co-buy detection** — when 2+ tracked wallets buy the same token within 60s, Ghost records a "co-buy" 3. **Cluster formation** — wallets with 3+ co-buys are grouped into clusters 4. **Convergence alerts** — when 3+ wallets from a cluster buy a NEW token, Ghost alerts you ## Configuration | Key | Default | Description | |-----|---------|-------------| | `coBuyWindowSec` | 60 | Time window for co-buy detection | | `minCoBuysForCluster` | 3 | Min co-buys to form cluster | | `minWalletsForAlert` | 3 | Min wallets for convergence alert | | `scanIntervalMs` | 30000 | Scan frequency (ms) | | `maxWallets` | 100 | Max tracked wallets | | `lookbackSec` | 86400 | Trade history lookback | ## Setup ```bash export SOLANA_RPC_URL="your-helius-url" # Helius recommended for parsed tx history ``` Helius RPC provides enriched transaction data (swap detection, token amounts) — much better than standard Solana RPC for wallet tracking.