Pump Scanner - AI-Powered Crypto Pump Detection

Real-time scanner that detects unusual price/volume spikes on CEX and DEX, scores them with LLM, and optionally auto-trades.

How It Works

Market Data → Spike Detection → LLM Scoring → Alert / Auto-Trade

1. Scans OKX spot pairs + DEX trending pools (GeckoTerminal)
2. Detects pumps: price +7% in 1h on CEX, +12% on DEX
3. Scores with local LLM: evaluates fundamentals, filters scams
4. Alerts via Telegram with chart link, liquidity, FDV
5. Auto-trades (optional): buys on OKX or PancakeSwap/Uniswap

Features

• Dual-source detection:
  • OKX: top 100 pairs by volume, 1h candlestick analysis
  • DEX: GeckoTerminal trending pools (ETH, BSC, Base, Solana, Arbitrum)
• LLM scoring (1-10):
  • Score 1-4: skip (likely scam/dead cat bounce)
  • Score 5-6: alert only
  • Score 7-10: alert + auto-trade candidate
• Anti-rug metrics: FDV/Liquidity ratio flagged in alerts
• Cooldown system: No re-alert on same token within configurable hours
• Auto-trader (optional):
  • CEX: OKX spot market orders
  • DEX: PancakeSwap/Uniswap via web3.py
  • Trailing stop: sell if drops 4% from peak (after +5% profit)
  • Budget cap, max concurrent positions, kill switch

Alert Example

🦎 🟢 PUMP DEGEN / USDT
  Price: $0.00145  (+13.5% in 1h)
  Chain: bsc/pancakeswap
  Liq: $1,221,478  FDV: $53,616,913
  🤖 LLM score: 6/10 — moderate volume, cautious optimism

Architecture

┌──────────────────────────────────────┐
│         Pump Scanner                 │
│                                      │
│  ┌──────────┐    ┌───────────────┐   │
│  │ OKX Scan │    │ DEX Trending  │   │
│  │ (CCXT)   │    │(GeckoTerminal)│   │
│  └────┬─────┘    └──────┬────────┘   │
│       └─────────┬───────┘            │
│          ┌──────▼──────┐             │
│          │   Detector  │             │
│          │ (+7%/+12%)  │             │
│          └──────┬──────┘             │
│          ┌──────▼──────┐             │
│          │  LLM Scorer │             │
│          │  (Ollama)   │             │
│          └──────┬──────┘             │
│       ┌─────────┼──────────┐        │
│  ┌────▼───┐ ┌───▼───┐ ┌───▼────┐   │
│  │Telegram│ │CEX Buy│ │DEX Buy │   │
│  │ Alert  │ │ (OKX) │ │(Pancake│   │
│  └────────┘ └───────┘ └────────┘   │
└──────────────────────────────────────┘

Configuration

{
  "okx": {
    "enabled": true,
    "price_change_1h_pct_min": 7.0,
    "top_n_by_volume": 100
  },
  "dex": {
    "enabled": true,
    "price_change_1h_pct_min": 12.0,
    "min_liquidity_usd": 100000
  },
  "llm": {
    "enabled": true,
    "model": "llama3.2:3b",
    "min_score_to_alert": 5
  },
  "cooldown_hours": 12,
  "max_alerts_per_cycle": 5
}

Requirements

• Python 3.10+
• CCXT
• Ollama (local LLM)
• web3.py (for DEX trading)

Disclaimer

This is a detection and alerting tool. Pump tokens are extremely high risk. Never invest more than you can afford to lose.

Author

Crypto automation developer. Available for custom bot development.