The explosive_threshold_pct parameter is the core sensitivity control of the Volatility Gate. It determines how much adverse smoothed movement must occur before a DCA order is held for observation. Proper tuning is critical to balance safety and responsiveness.
๐น 1๏ธโฃ Purpose of explosive_threshold_pct
Higher Value:
- Only extremely fast or large moves trigger the gate.
- Most DCA orders fire immediately during normal price dips.
- Best for stable assets like BTC or ETH.
Lower Value:
- Even moderate rapid moves trigger a hold.
- Reduces risk in high-volatility altcoins, preventing DCA stacking in sharp crashes or pumps.
- May delay more orders than necessary in stable markets.
๐น 2๏ธโฃ How to Tune
Assess the Assetโs Volatility:
BTC / Large Caps:
- Price rarely jumps 5โ7% in minutes.
- Use 4โ5% to catch only rare explosive events.
Low-Cap / Meme Coins:
- Price can swing 5โ15% in minutes.
- Use 1.5โ3% to capture frequent momentum spikes.
Decide Your Risk Appetite:
- Conservative: lower threshold โ more orders held โ safer, slower DCA.
- Aggressive: higher threshold โ fewer holds โ faster DCA execution, higher exposure.
Monitor Logs During Demo:
Check for messages:
๐ญ Volatility gate: HELDโ how often orders are delayedโ Volatility gate: CLEARโ orders firing immediately
- Adjust to achieve a balance between avoiding explosive exposure and keeping DCA flow smooth.
Combine With Observation Settings:
Lower explosive threshold works best with:
required_neutral_streak = 2โ3max_observation_minutes = 120โ180
- This ensures DCA orders are only released when momentum truly stabilizes.
๐น 3๏ธโฃ Practical Examples
| Asset Type | Market Behavior | Suggested Explosive Threshold |
|---|---|---|
| BTC | Generally stable, moderate dips | 4.0 โ 5.0% |
| ETH | Medium volatility | 3.5 โ 4.5% |
| Low-Cap Altcoins | Rapid spikes, crashes common | 1.5 โ 3.0% |
Example: A $5,000 position in a low-cap coin drops 6% in 10 minutes.
- Threshold = 3% โ DCA held, waits for momentum cooldown โ better average entry.
- Threshold = 5% โ DCA fires immediately โ exposes capital to ongoing crash.
๐น 4๏ธโฃ Summary
explosive_threshold_pctcontrols how sensitive Volatility Gate is to rapid market movements.- Lower value: safer, more DCA holds, ideal for volatile assets.
- Higher value: fewer holds, faster DCA, better for stable coins.
- Tune based on asset volatility, personal risk tolerance, and observation settings.
- Always validate in demo mode before live trading.
Think of it as the โvolatility sensitivity knobโ: turn it down for safety, up for speed โ the key is finding the right balance for each asset type.