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.