Crypto Wave Scanner

Detects crypto futures wave entries and exits using a 6-signal scoring system. Outputs a live browser dashboard (candlestick charts + indicators) and a CLI scanner.

Quick Start

Browser Dashboard (recommended)

# Start the local server
python3 scripts/serve.py

# Opens automatically at http://localhost:7890/wave-scanner.html

Dashboard auto-refreshes every 60 seconds. Filter by timeframe (5m/15m/1h/4h) and minimum score.

CLI Scanner

python3 scripts/wave_scanner.py
python3 scripts/wave_scanner.py --min-score 5          # strong setups only
python3 scripts/wave_scanner.py --symbols BTC ETH SOL  # specific coins

Scoring System (0-6)

Each coin is scored on 6 signals:

Grades: 5-6 = 🔥 STRONG SETUP · 4 = ✅ VALID · 3 = ⚠️ WEAK · <3 = ❌ SKIP

Entry / Exit Rules

Enter when: Score ≥ 5 AND RSI 50-75. Place LIMIT order at EMA9 level (shown in dashboard).

Skip when: RSI > 85 (wave mature). RSI > 88 = do not add longs.

Exit when (any one):

• EMA9 crosses below EMA21
• RSI > 85 AND price closes below EMA9
• Volume drops for 3 consecutive candles on new highs
• Large bearish engulfing candle

Assets

• assets/wave-scanner.html — self-contained browser dashboard (TradingView Lightweight Charts)
• scripts/wave_scanner.py — CLI scanner with full signal breakdown
• scripts/serve.py — local HTTP server launcher

Data Source

Uses public Binance Futures API (https://fapi.binance.com) — no API key needed for scanning.

For testnet trading with the Binance Futures Testnet, swap base URL to https://testnet.binancefuture.com.

Coins Scanned by Default

BTCUSDT, ETHUSDT, SOLUSDT, XRPUSDT, BNBUSDT, AVAXUSDT, LINKUSDT, DOGEUSDT, LTCUSDT, DOTUSDT