Volatility Gate is a safety-first mechanism designed to prevent DCA from stacking orders during explosive market moves. Proper tuning ensures maximum protection while still allowing trades to execute when the market stabilizes.

🔹 1️⃣ Understand the Safety Objective

The goal of maximum safety tuning is:

• Avoid stacking DCA orders during high-momentum crashes or pumps
• Reduce potential drawdowns
• Prevent margin stress or liquidation
• Ensure orders execute only when probability of recovery is higher

In other words:

Prioritize capital protection over aggressive entry timing.

🔹 2️⃣ Core Parameters for Safety

The Volatility Gate has several key settings that control how aggressively it blocks DCA orders:

🔹 3️⃣ Recommended Maximum Safety Settings

For ultra-safe protection:

volatility_gate:
  enabled: true
  explosive_threshold_pct: 2.0       # Sensitive to smaller adverse momentum
  neutral_threshold_pct: 0.3         # Market must nearly neutralize before release
  reversal_threshold_pct: -0.3       # Only early reversal triggers release
  required_neutral_streak: 3         # Wait for three consecutive neutral/reversal readings
  candles_to_analyze: 20             # Use 20 1m candles for smoothed momentum
  max_observation_minutes: 180       # Safety timeout extended to 3 hours

Effect:

• Almost all high-momentum moves will trigger observation
• Orders only fire after strong confirmation of stability
• Maximum drawdown risk is minimized

🔹 4️⃣ Step-by-Step Tuning Logic for Safety

1️⃣ Lower Explosive Threshold

• Detects smaller momentum spikes
• Prevents DCA from adding during moderate surges
• Recommended range: 1.5% – 2.5%

2️⃣ Tight Neutral Threshold

• Market must stabilize almost fully before release
• Prevents DCA from firing during short pauses in the crash
• Recommended: 0.3% – 0.5%

3️⃣ Higher Neutral Streak Requirement

• Ensures confirmation is consistent
• Prevents one or two candles from triggering order prematurely
• Recommended: 2 – 3 consecutive neutral/reversal readings

4️⃣ Longer Max Observation

• Gives extreme crashes or pumps enough time to settle
• Recommended: 120 – 180 minutes

5️⃣ Candle Analysis Window

• 15–25 candles recommended for smoothed movement
• Smoothing prevents false positives from single spikes

🔹 5️⃣ Optional Aggressive Safety Tweaks

• Increase candles_to_analyze → smoother signal, slower execution
• Lower explosive_threshold_pct further → blocks even moderate volatility
• Increase required_neutral_streak → stricter confirmation

Trade-off:

Orders execute later — fewer risk exposures, but may miss small dips.

🔹 6️⃣ Monitoring and Logs for Safety

Check the following logs to ensure safety tuning is working:

Regularly review logs during live/demo trading to confirm the gate is catching explosive moves as expected.

🔹 7️⃣ Safety Tuning Principles

1. Prioritize protection over speed — max safety delays execution to avoid loss stacking
2. Observe longer in extreme moves — increase max_observation_minutes if volatile periods are frequent
3. Confirm stabilization with streak — never release based on single candle pause
4. Balance sensitivity and usability — extremely low thresholds may block normal DCA opportunities, so test in demo first

🔹 8️⃣ Summary

To tune Volatility Gate for maximum safety:

• Use low explosive threshold (≈2%)
• Require tight neutralization (≈0.3–0.5%)
• Require multiple consecutive confirmations (neutral streak = 3)
• Observe longer max observation (120–180 minutes)
• Smooth over 20+ 1m candles to avoid noise

Result:

The bot will act conservatively, avoiding “falling knife” situations, reducing drawdowns, and protecting capital while still allowing controlled, well-timed DCA execution.

If you want, I can also create a visual safety tuning guide, showing how threshold levels affect DCA execution during crashes and pumps. This is very helpful for new users.