# Ghost Alpha

> Ghost Alpha — Track smart wallets, discover wallet clusters, get convergence alerts when multiple smart wallets buy the same token. The 'hunt' half of Ghost.

- Skill: `alsk1992/ghost-alpha` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add alsk1992/ghost-alpha`
- Raw SKILL.md: https://api.skillmd.com/api/skills/alsk1992/ghost-alpha/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: alsk1992 (https://skillmd.com/u/alsk1992)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/alsk1992/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.