The LockPercent feature is a volatility-based safety mechanism that temporarily blocks new trade entries when market movement exceeds a defined threshold.
It acts as a protective filter during chaotic market conditions.
Example:
LockPercent: 0.3
If volatility exceeds 0.3% (based on your configured candle analysis):
- 🚫 New trades will not be opened
- 📢 Alerts will still be sent (if enabled)
- 📊 Monitoring continues normally
Only order placement is restricted.
🎯 What Problem Does It Solve?
During extreme volatility, traders often:
- Chase pumps
- Panic short crashes
- Overtrade rapid movements
- Enter at poor prices
The LockPercent feature prevents the bot from opening new positions when the market becomes unstable.
It protects you from:
- Emotional entries
- FOMO trades
- Slippage-heavy environments
- Spread expansion
⚙️ How It Works
- The system continuously calculates average market movement.
If volatility exceeds the
LockPercentthreshold:- A temporary trading lock activates.
While locked:
- Manual trades are blocked.
- Auto-trades are blocked.
- Strategy-triggered entries are blocked.
- Existing trades remain unaffected.
Once volatility falls back below the threshold, trading resumes automatically.
📊 Example Scenario
You configure:
LockPercent: 0.5
Market suddenly pumps +1.2% within minutes.
Result:
- Trade lock activates.
- No new orders are allowed.
- Alerts may still notify you.
- Existing positions continue normally.
When volatility cools down:
- Lock is lifted.
- Trading resumes automatically.
🛡️ Why This Is Important
In extreme conditions:
- Order books thin out.
- Slippage increases.
- Fake breakouts occur.
- Whipsaws become common.
The trade lock ensures the bot does not:
- Enter late into explosive moves.
- Trade during liquidity shocks.
- Compound risk in unstable conditions.
It enforces discipline automatically.
🔧 Choosing a LockPercent Value
Lower Value (0.2%–0.4%)
- Locks quickly
- Very protective
- Suitable for cautious traders
Medium Value (0.5%–0.8%)
- Balanced control
- Avoids chaotic entries
- Good for intraday traders
Higher Value (1%+)
- Only blocks during extreme events
- Allows more flexibility
🚀 Key Advantage
Unlike emergency close:
- LockPercent does NOT close trades.
- It only prevents new entries.
- It works as a preventive shield.
You still receive Telegram / Discord alerts — you’re informed, but protected from impulsive execution.
📌 Summary
LockPercent temporarily blocks new trades when volatility exceeds a defined threshold.
It helps prevent:
- Overtrading
- Chasing pumps or crashes
- Entering during chaotic market conditions
Monitoring and alerts continue, but order placement is safely restricted until volatility stabilizes.