What is AverageMovementPercent?

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:

1. Takes the configured number of candles (e.g., 10 candles on 1m timeframe = 10 minutes).
2. Measures the percentage price movement.
3. Computes the average directional movement.
4. 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.