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.

📎 Related Topics