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 relative strength versus BTC
• follow-through and late-entry logic

Signal stages

pump_watch

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

pump_signal

Higher-confidence alert indicating stronger momentum continuation conditions.

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
rel_strength_1h_min = 4.0
follow_vol_ratio_min = 1.5
late_entry_atr_mult = 5.0
min_quote_volume_usd = 200000
stage2_expiry_candles = 3

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
• rel_strength_15m_min / rel_strength_1h_min: BTC-relative strength filters
• late_entry_atr_mult: marks stretched follow-up entries as late
• stage2_expiry_candles: how long stage-2 logic remains valid

Persistence

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

Main table:

• pump_signals

Stored fields include:

• stage / confidence
• ignition 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