AverageMovementPercent defines the minimum average price movement (in percentage) required across the configured candle window to trigger a volatility alert.
It is the primary threshold used to detect when the market is experiencing a meaningful pump or crash.
Example configuration:
AverageMovementPercent: 1.1
This means:
- If the average price movement across the selected candles reaches ยฑ1.1%
- The system will broadcast an alert
- No trades are automatically opened or closed unless other features are enabled
๐ How It Is Calculated
The system:
- Takes the configured number of candles (e.g., 10 candles on 1m timeframe = 10 minutes).
- Measures the percentage price movement.
- Computes the average directional movement.
- Compares it against
AverageMovementPercent.
If the movement exceeds the threshold:
- Upward โ Pump detected
- Downward โ Crash detected
๐จ What Happens When It Is Triggered?
When the threshold is reached, the bot sends broadcast alerts to:
- Telegram
- Discord
- UI dashboard
- Other configured channels
Example Discord alert:
PUMP DETECTED ๐
3 symbols detected with average +1.10% movement
๐ ETHUSDT
+1.53% over 10 min
Price: $2066.4500 โ $2094.5000
Range: $2053.5000 - $2108.7200
Volatility: 2.67%
๐ SOLUSDT
+1.05% over 10 min
Price: $85.5402 โ $86.2260
Range: $85.1480 - $86.8340
Volatility: 1.97%
๐ BTCUSDT
+0.73% over 10 min
Price: $69658.1500 โ $70043.4000
Range: $69414.8000 - $70399.0000
Volatility: 1.41%
This gives you immediate visibility into:
- Which symbols are moving
- The strength of the move
- The time window of movement
- Price ranges and volatility expansion
๐ฏ Why It Matters
AverageMovementPercent helps you:
- Detect market expansion early
- Identify breakout conditions
- Recognize crash scenarios
- Prepare for potential reversals
- React before liquidation risk increases
It acts as an early warning system.
โ๏ธ How to Choose the Right Value
Lower value (e.g., 0.5%โ0.8%)
- More sensitive
- More alerts
- Suitable for scalping environments
Medium value (e.g., 1.0%โ1.5%)
- Balanced detection
- Filters minor noise
- Suitable for intraday trading
Higher value (e.g., 2%+)
- Detects only strong volatility events
- Fewer but more significant alerts
- Suitable for high-impact news tracking
๐ Summary
AverageMovementPercent is the alert trigger threshold that defines how much average price movement must occur before the system broadcasts a pump or crash notification.
It does not:
- Open trades
- Close trades
- Lock trading
It simply informs you that abnormal volatility is happening โ giving you the awareness needed to act quickly.