The observation phase is the core period when the Volatility Gate monitors a DCA order after it has been held due to explosive momentum. During this phase, the bot carefully tracks market conditions to determine the safest moment to release the order.
๐น 1๏ธโฃ Triggering Observation
- A DCA order enters observation if the smoothed adverse movement exceeds
explosive_threshold_pctat the moment the DCA trigger fires. - The order is not immediately placed, and the bot begins a structured watch cycle.
๐น 2๏ธโฃ Continuous Market Monitoring
While in observation, the bot performs the following steps every 60 seconds (default polling interval):
- Calculate smoothed movement from the most recent 1-minute candles (as configured in
candles_to_analyze) Determine adverse movement relative to trade direction:
Long trades โ falling price = adverse
Short trades โ rising price = adverse
Compare adverse movement to thresholds:
Neutral threshold: Has the momentum stalled?
Reversal threshold: Has the trend started reversing?
Update streak counters:
Each consecutive reading below neutral or reversal thresholds counts toward
required_neutral_streak- Any reading above thresholds resets the streak, ensuring only consistent stabilization triggers release
๐น 3๏ธโฃ Protective Safety Checks
The observation phase also incorporates safety mechanisms:
Maximum Observation Timeout (
max_observation_minutes)Prevents orders from being held indefinitely
After this timeout, the order is force-released at the current live price
Log Monitoring
Real-time logs track observation status:
| Log Message | Meaning |
|---|---|
| ๐ญ Volatility Gate: HELD | DCA held, observation active |
| ๐๏ธ DCA Observer: still volatile | Market still moving above thresholds, streak reset |
| โ DCA Observer: RELEASING | Neutral/reversal streak reached, order released |
| โ DCA Observer: Force-releasing | Timeout reached, order released regardless of conditions |
๐น 4๏ธโฃ Dynamic Adjustments During Observation
- Continuous smoothed movement calculation ensures the system reacts to real-time price changes
- Trend reversal detection allows DCA execution at safer prices rather than during continuing crashes/pumps
- Neutral streak requirement avoids premature firing due to brief pauses in momentum
๐น 5๏ธโฃ Example Scenario
- Symbol triggers DCA at -7% deviation
- Smoothed movement = -4.2% โ exceeds explosive threshold
- Observation starts:
| Minute | Smoothed Adverse Movement | Status | Streak |
|---|---|---|---|
| 0 | -4.2% | HELD | 0 |
| 1 | -2.1% | Still volatile | 0 |
| 2 | -0.4% | Neutral | 1 |
| 3 | -0.2% | Neutral/Reversal | 2 โ DCA Released |
- Outcome: DCA executes at safer entry, avoiding catching the middle of a crash
๐น 6๏ธโฃ Key Benefits of Observation Phase
- Avoids chasing high-momentum moves โ reduces risk of large drawdowns
- Improves average entry price โ DCA fires closer to actual recovery lows/highs
- Maintains disciplined DCA execution โ combines explosive, neutral, and reversal thresholds with streak confirmation
- Protects account capital during volatile sessions โ crucial for small-cap or high-volatility assets
๐น 7๏ธโฃ Summary
The observation phase is a critical protective period where:
- The bot holds the DCA order
- Monitors smoothed adverse movement continuously
- Tracks streaks of neutral or reversal readings
- Only releases the order when momentum has cooled or reversed, or after a safety timeout
This phase turns a standard DCA into a professional, momentum-aware strategy, ensuring your bot avoids adding to positions during dangerous market spikes.