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.