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:

Parameter	Safety Tuning Focus
explosive_threshold_pct	Lower value → more sensitive → blocks more orders during smaller volatility spikes
neutral_threshold_pct	Tight value → requires market to stabilize further before releasing orders
reversal_threshold_pct	Detects early trend reversal → prevents premature release into ongoing crash
required_neutral_streak	Higher value → needs more consecutive confirmations before DCA fires
max_observation_minutes	Ensures extreme moves don’t trigger immediate execution

🔹 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:

Log Message	Meaning
🔭 Volatility gate: HELD	Order held due to high momentum
👁️ DCA Observer: still volatile	Momentum still too high, streak reset
✅ DCA Observer: RELEASING	Order firing only after confirmed stability
⌚ DCA Observer: Force-releasing	Safety timeout triggered

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

🔹 7️⃣ Safety Tuning Principles

Prioritize protection over speed — max safety delays execution to avoid loss stacking
Observe longer in extreme moves — increase max_observation_minutes if volatile periods are frequent
Confirm stabilization with streak — never release based on single candle pause
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.

How to Tune Volatility Gate for Maximum Safety