What is max_observation_minutes and why is it necessary?

The max_observation_minutes setting in the Volatility Gate defines the maximum duration a held DCA order can remain in observation before it is force-released, regardless of market conditions. It acts as a critical safety net for long or extreme volatility events.

🔹 1️⃣ Purpose of `max_observation_minutes`

Prevents indefinite holding
- During prolonged crashes or pumps, the market may remain above the explosive threshold for hours.
- Without a timeout, a DCA order could be never placed, leaving positions unmanaged.
Guarantees eventual execution
- Ensures that all triggered DCA orders are eventually placed even if the market doesn’t stabilize quickly.
- Provides predictable behavior for monitoring and risk management.
Balances safety with opportunity
- Observation protects against chasing explosive moves.
- Timeout ensures the bot still participates in the trade instead of missing potential recovery or trend continuation.

🔹 2️⃣ How It Works in Practice

When a DCA order is held due to explosive movement, a timer starts.
The order is monitored every 60 seconds during the observation phase.
If neutral or reversal streaks are achieved before the timeout, the order is released early.
If the maximum observation time elapses, the order is force-released at the current live price, even if momentum is still high.

Example:

max_observation_minutes = 120
DCA triggered and held at T=0
Market remains volatile for 2 hours → streak not achieved
At T=120 minutes → order force-released to ensure execution

🔹 3️⃣ Key Benefits

Benefit	Description
Safety Net	Prevents orders from being stuck indefinitely in extreme market conditions
Predictable Risk Management	Traders know that all DCA orders will eventually execute within a defined window
Combines Flexibility with Control	Observation protects against chasing momentum, timeout ensures participation
Avoids Missed Opportunities	Even prolonged volatile moves won’t prevent the DCA strategy from completing its plan

🔹 4️⃣ Recommended Usage

Default: 120 minutes (good starting point for most assets)
For highly volatile low-cap symbols: consider 150–180 minutes
For stable, large-cap assets: 60–90 minutes may be sufficient
Should be tested in demo mode to observe how the timeout interacts with actual price movements

🔹 5️⃣ Summary

max_observation_minutes is the maximum duration a DCA order can remain held under the Volatility Gate. It is necessary to:

Ensure all DCA orders are eventually placed
Protect against indefinite delays during extreme volatility
Provide a predictable, safe, and disciplined DCA execution framework

In essence, it is the safety timeout that balances the protective logic of observation with the practical need to execute trades.