Pump Momentum Scanner

Pump Momentum is an alert-first scanner. It does not create trades directly.

Purpose

• Detect sudden momentum bursts on Binance spot symbols
• Send timely Telegram alerts
• Persist signal observations for later outcome analysis

Core idea

The scanner looks for abnormal short-term momentum using:

• 15m volume expansion
• 15m candle return
• 15m close strength
• 15m relative strength versus BTC
• late-entry labeling for stretched moves

Signal type

pump_watch

Early alert that a symbol is becoming interesting but has not yet reached a stronger breakout state.

Confidence levels

• low
• medium
• high

These are alert labels, not order instructions.

Config section

Configured under:

[strategy.pump_momentum]
enabled = true
use_universe = true
watchlist_override = []
scan_limit_15m = 80
vol_ratio_threshold = 3.0
candle_return_min_pct = 2.5
close_strength_min = 0.70
rel_strength_15m_min = 2.0
late_entry_atr_mult = 5.0
min_quote_volume_usd = 200000

Key meanings:

• use_universe: scan the configured universe instead of only a small watchlist override
• scan_limit_15m: number of 15m candles fetched per symbol
• vol_ratio_threshold: minimum ignition volume ratio
• close_strength_min: require the 15m candle to close near its high
• rel_strength_15m_min: BTC-relative strength filter on the watch candle
• late_entry_atr_mult: marks already-stretched pump-watch alerts as late

Persistence

Pump Momentum persists events to SQLite through app/strategies/pump_signals_db.py.

Main table:

• pump_signals

Stored fields include:

• pump_watch / confidence
• candidate candle data
• price, volume, ATR, relative strength metrics
• later outcome evaluation fields

Outcome tracking

The scanner is paired with outcome evaluation tooling so alerts can be reviewed after the fact.

Relevant tooling:

• scripts/pump_outcome_eval.py

Typical outcome fields include:

• price_1h_after
• price_4h_after
• price_24h_after
• mfe_*
• mae_*
• reach / reversal flags

Schedule

The scanner runs every 5 minutes via cron (*/5 * * * *), triggered by the SCOUT agent.

API surface

• GET | POST /api/pump-momentum/scan
• GET /api/pump-momentum/signals
• GET /api/pump-momentum/signals/{symbol}

POST /api/pump-momentum/scan returns alerts and also sends Telegram notifications server-side.

Difference from MR Combined