Market Watch - Complete User Guide

Overview

Market Watch is an intelligent market monitoring system that protects your positions and captures extreme volatility opportunities. It analyzes real-time market movements across multiple symbols and automatically responds with four protective and opportunistic layers.

πŸ†• NEW in v2.0: Auto-Trade now includes built-in DCA, custom stop-loss, and maximum hold time protection!

🎯 Core Features

1. Market Movement Monitoring

  • Continuously analyzes price movements across configured symbols
  • Calculates average market movement percentage
  • Detects crashes (downward) and pumps (upward) movements
  • Logs all movements to file for historical analysis

2. Four-Layer Response System

Layer 1: Alert Broadcasting πŸ“’

Purpose: Keep you informed of significant market movements

  • Sends alerts to Telegram/Discord when threshold is breached
  • Includes detailed movement data per symbol
  • Acts as early warning system

Layer 2: Emergency Close πŸ›‘οΈ

Purpose: Protect existing positions during extreme movements

  • Automatically closes positions moving against you
  • Crash β†’ Closes all LONG positions
  • Pump β†’ Closes all SHORT positions
  • Respects minimum hold time to avoid premature exits

Layer 3: Trade Locking πŸ”’

Purpose: Prevent new trades during high volatility

  • Locks new trade signals when volatility exceeds threshold
  • Auto-unlocks when market stabilizes
  • Protects capital during uncertain periods

Layer 4: Auto-Trade πŸ’° ENHANCED

Purpose: Capitalize on extreme reversal opportunities

  • Automatically places trades during extreme movements
  • Buys the dip on crashes (Long)
  • Shorts the peak on pumps (Short)
  • πŸ†• Built-in DCA for dollar-cost averaging
  • πŸ†• Custom stop-loss protection
  • πŸ†• Maximum hold time safety

βš™οΈ Configuration

Basic Configuration

MarketWatch:
  Enabled: true

  # -----------------------------------------------------------
  # Symbols to Monitor
  # -----------------------------------------------------------
  Symbols:
    - "BTCUSDT"
    - "ETHUSDT"
    - "SOLUSDT"
    - "BNBUSDT"
    # Add more symbols as needed

  # -----------------------------------------------------------
  # Analysis Settings
  # -----------------------------------------------------------
  Candles: 10                           # Number of 1-min candles to analyze
                                        # 10 candles = 10 minutes of data

  # -----------------------------------------------------------
  # Layer Thresholds (in %)
  # -----------------------------------------------------------
  AverageMovementPercent: 1.1           # Alert threshold
  AverageMovementEmergencyClose: 0.6    # Emergency close threshold
  LockPercent: 0.3                      # Lock trades threshold (0 = disabled)

  # -----------------------------------------------------------
  # Emergency Close Settings
  # -----------------------------------------------------------
  EmergencyCloseMinHoldTime: 20         # Minimum minutes before emergency close
                                        # 0 = Apply immediately

πŸ†• Enhanced Auto-Trade Configuration

  # -----------------------------------------------------------
  # Auto-Trade on Extreme Volatility (ENHANCED v2.0)
  # -----------------------------------------------------------
  AutoTrade:
    Enabled: true                       # Enable/disable automatic trade execution

    Threshold: 1.8                      # % average movement to trigger auto-trade
                                        # Must be higher than alert threshold

    Direction: "Both"                   # Trading direction:
                                        # "Long"  β†’ Buy dips only
                                        # "Short" β†’ Short pumps only
                                        # "Both"  β†’ Trade both directions

    Symbols:                            # Symbols allowed for auto-trading
      - "BTCUSDT"                       # (can differ from monitor symbols)
      - "ETHUSDT"
      - "SOLUSDT"

    InitialAmount: 100                  # Initial order size per symbol (USDT)

    # πŸ†• Maximum Hold Time Protection
    MaximumHoldTime: 180                # Maximum minutes to hold auto-trade
                                        # Trade closes after this duration
                                        # regardless of P&L
                                        # 0 = no time limit
                                        # Examples:
                                        #   60 = 1 hour max
                                        #  120 = 2 hours max
                                        #  180 = 3 hours max

    # -----------------------------------------------------------
    # πŸ†• Stop-Loss Configuration (Auto-Trade Specific)
    # -----------------------------------------------------------
    StopLoss:
      Enabled: true                     # Enable stop-loss for auto-trades

      StopLossPercent: 4                # Stop-loss % from average entry
                                        # Calculated from:
                                        # - Average entry (if DCA enabled)
                                        # - Initial entry (if DCA disabled)
                                        # Examples:
                                        #   4 = Close at -4% loss
                                        #   5 = Close at -5% loss
                                        # Works for BOTH Long and Short

    # -----------------------------------------------------------
    # πŸ†• Built-in DCA for Auto-Trades
    # -----------------------------------------------------------
    DCASettings:
      enabled: true                     # Enable DCA for auto-trades

      max_orders: 5                     # Total orders including initial
                                        # Example: 1 initial + 4 DCA orders

      size_multiplier: 1.2              # Each DCA order size multiplier
                                        # 1.0 = same size
                                        # 1.2 = 20% larger each time
                                        # 1.5 = 50% larger each time

      price_deviation_percent: 1.0      # % price drop to trigger next DCA
                                        # Example: 1.0 = every 1% move
                                        # Lower = more aggressive
                                        # Higher = more conservative

πŸ“‹ Configuration Parameters Explained

Core Settings

Symbols

  • What: List of trading pairs to monitor for volatility
  • Example: ["BTCUSDT", "ETHUSDT"]
  • Tip: Include major coins for best market representation
  • Note: Monitor symbols can differ from auto-trade symbols

Candles

  • What: Number of 1-minute candles to analyze
  • Default: 10 (= 10 minutes)
  • Range: 5-20 recommended
  • Tip: Higher = smoother but slower response

AverageMovementPercent

  • What: Alert broadcast threshold
  • Default: 1.1%
  • Purpose: Get notified of significant movements
  • Tip: Set based on typical market volatility

AverageMovementEmergencyClose

  • What: Emergency position close threshold
  • Default: 0.6%
  • Purpose: Protect from larger adverse movements
  • Tip: Should be lower than alert threshold
  • Warning: Too low = frequent emergency closes

EmergencyCloseMinHoldTime

  • What: Minimum minutes a trade must be open before emergency close
  • Default: 20 minutes
  • Purpose: Prevent closing trades during normal entry volatility
  • Examples:
    • 0 = Apply emergency close immediately
    • 20 = Trade must be at least 20 minutes old
    • 60 = Trade must be at least 1 hour old
  • Tip: Set to 15-30 minutes for scalping, 60+ for swing trades

LockPercent

  • What: Volatility threshold to lock new trades
  • Default: 0.3%
  • Purpose: Prevent entering during choppy markets
  • Special: Set to 0 to disable locking feature
  • Tip: Keep lower than emergency close threshold

πŸ†• Auto-Trade Settings

AutoTrade.Threshold

  • What: Extreme movement threshold to trigger auto-trades
  • Default: 1.8%
  • Purpose: Capture reversal opportunities
  • Tip: Should be highest threshold (2x-3x alert threshold)
  • Warning: Too low = too many trades, too high = missed opportunities

AutoTrade.Direction

  • Options:
    • "Long" - Only buy dips (crashes)
    • "Short" - Only short pumps
    • "Both" - Trade both directions
  • Recommended: "Both" for maximum opportunities
  • Conservative: "Long" (safer in bull markets)

AutoTrade.InitialAmount

  • What: USDT amount for initial auto-trade entry per symbol
  • Default: 100 USDT
  • Example: 3 symbols Γ— $100 = $300 initial capital per event
  • Tip: Start conservative, increase as confidence grows

πŸ†• AutoTrade.MaximumHoldTime

  • What: Maximum minutes to hold an auto-trade position
  • Default: 180 minutes (3 hours)
  • Purpose: Force exit after time limit regardless of P&L
  • Examples:
    • 60 = Close after 1 hour (scalping)
    • 120 = Close after 2 hours (day trading)
    • 180 = Close after 3 hours (swing trading)
    • 0 = No time limit (not recommended)
  • Tip: Match to your trading style and market conditions
  • Why Important: Prevents holding losing positions indefinitely

πŸ†• AutoTrade.StopLoss.StopLossPercent

  • What: Stop-loss percentage from average entry price
  • Default: 4%
  • Calculation:
    • With DCA: Calculated from average entry of all filled orders
    • Without DCA: Calculated from initial entry price
  • Examples:
    • 4 = Close at -4% loss (recommended)
    • 3 = Close at -3% loss (tighter)
    • 5 = Close at -5% loss (looser)
  • Works for Both Directions:
    • Long: Triggers when price drops 4% from average entry
    • Short: Triggers when price rises 4% from average entry
  • Tip: With 5x leverage, 4% stop = 20% capital loss

πŸ†• AutoTrade.DCASettings.max_orders

  • What: Total number of orders including initial entry
  • Default: 5 (1 initial + 4 DCA)
  • Examples:
    • 3 = 1 initial + 2 DCA (conservative)
    • 5 = 1 initial + 4 DCA (balanced)
    • 7 = 1 initial + 6 DCA (aggressive)
  • Tip: More orders = better average but higher capital requirement

πŸ†• AutoTrade.DCASettings.size_multiplier

  • What: Multiplier for each subsequent DCA order size
  • Default: 1.2 (20% larger)
  • Examples:
    • 1.0 = Equal sizing ($100, $100, $100...)
    • 1.2 = Pyramid sizing ($100, $120, $144...)
    • 1.5 = Aggressive pyramid ($100, $150, $225...)
  • Tip: 1.2 balances risk and averaging efficiency

πŸ†• AutoTrade.DCASettings.price_deviation_percent

  • What: Price movement % to trigger next DCA order
  • Default: 1.0% (every 1% drop for long, 1% rise for short)
  • Examples:
    • 0.5 = Very aggressive (triggers often)
    • 1.0 = Balanced (recommended)
    • 2.0 = Conservative (less frequent)
  • Tip: Lower values = more DCA orders filled faster

🎬 How It Works - Real Example

Scenario: Market Crash with New Features

Time: 10:00 AM - Market starts dropping rapidly
BTC: -2.8% in 10 minutes
ETH: -3.1% in 10 minutes  
SOL: -2.5% in 10 minutes
Average: -2.8%

System Response (in order):

Step 1: Alert (1.1% threshold) βœ…

🚨 Market Crash detected!
Average movement: -2.8%
- BTCUSDT: -2.8%
- ETHUSDT: -3.1%
- SOLUSDT: -2.5%

Alert sent to Telegram/Discord

Step 2: Emergency Close (0.6% threshold) βœ…

⚠️ Emergency close triggered!
Closing all LONG positions to prevent further losses

Existing long positions closed (if older than 20 min)

Step 3: Lock Trades (0.3% threshold) βœ…

πŸ”’ Trades locked due to high volatility
No new signals will be executed

System prevents random entries during chaos

Step 4: Auto-Trade Triggered (1.8% threshold) βœ…

πŸš€ Auto-trade triggered at -2.8%!

Entry 1 (Initial): -2.8% movement
β”œβ”€ BTCUSDT: $100 @ $93,000
β”œβ”€ ETHUSDT: $100 @ $2,800
└─ SOLUSDT: $100 @ $175
Total: $300 invested
Stop-Loss set at: -4% from entry
Max hold time: 180 minutes

Step 5: πŸ†• DCA Activates (If crash continues)

10:05 AM: Market drops to -3.8%

DCA Entry 2 triggered (1% gap from -2.8%)
β”œβ”€ BTCUSDT: $120 @ $92,000
β”œβ”€ ETHUSDT: $120 @ $2,770
└─ SOLUSDT: $120 @ $173
Total invested: $660
Average entry: -3.3%
Stop-Loss updated: -4% from new average

10:10 AM: Market drops to -4.8%

DCA Entry 3 triggered
β”œβ”€ BTCUSDT: $144 @ $91,000
β”œβ”€ ETHUSDT: $144 @ $2,740
└─ SOLUSDT: $144 @ $171
Total invested: $1,092
Average entry: -3.8%
Stop-Loss updated: -4% from new average

Step 6: Recovery Phase

10:20 AM: Market stabilizes at -3.0%
10:35 AM: Market recovers to +1.5%

πŸ“ˆ Auto-trades in profit as market recovers!

Position Summary:
β”œβ”€ Average entry: -3.8%
β”œβ”€ Current price: +1.5%
β”œβ”€ Total swing: 5.3%
β”œβ”€ Profit: ~$95-120 (with leverage)
└─ Time held: 35 minutes

πŸ”“ Trades unlocked - volatility normalized

Step 7: πŸ†• Protection Scenarios

Scenario A: Stop-Loss Triggered

If market continued to -7.8% instead of recovering:
β”œβ”€ Average entry: -3.8%
β”œβ”€ Stop-loss: -7.8% (4% below average)
β”œβ”€ Current: -8.0%
└─ Action: 🚨 CLOSE ALL AUTO-TRADES
   └─ Reason: "Auto-trade stop-loss triggered: -8.0% ≀ -7.8%"
   └─ Loss: ~$160 (protected from worse)

Scenario B: Max Hold Time

If market went sideways for 3+ hours:
β”œβ”€ Entry time: 10:00 AM
β”œβ”€ Current time: 1:05 PM
β”œβ”€ Held for: 185 minutes
β”œβ”€ Max hold: 180 minutes
└─ Action: 🚨 CLOSE ALL AUTO-TRADES
   └─ Reason: "Maximum hold time exceeded (185min > 180min)"
   └─ Exit at current P&L (whatever it is)

πŸ’‘ Configuration Strategies

Conservative (Low Risk)

MarketWatch:
  AverageMovementPercent: 1.5          # Less frequent alerts
  AverageMovementEmergencyClose: 0.8   # Tighter protection
  EmergencyCloseMinHoldTime: 30        # Longer hold time
  LockPercent: 0.4                     # More aggressive locking

  AutoTrade:
    Enabled: true
    Threshold: 3.0                     # Only extreme events
    Direction: "Long"                  # Only buy dips
    InitialAmount: 50                  # Smaller positions
    MaximumHoldTime: 60                # 1-hour max (quick exits)

    StopLoss:
      Enabled: true
      StopLossPercent: 3               # Tighter stop-loss

    DCASettings:
      enabled: true
      max_orders: 3                    # Fewer DCA levels
      size_multiplier: 1.0             # Equal sizing (safer)
      price_deviation_percent: 1.5     # Wider gaps

Balanced (Recommended)

MarketWatch:
  AverageMovementPercent: 1.1
  AverageMovementEmergencyClose: 0.6
  EmergencyCloseMinHoldTime: 20
  LockPercent: 0.3

  AutoTrade:
    Enabled: true
    Threshold: 1.8
    Direction: "Both"
    InitialAmount: 100
    MaximumHoldTime: 180               # 3-hour max

    StopLoss:
      Enabled: true
      StopLossPercent: 4               # Balanced protection

    DCASettings:
      enabled: true
      max_orders: 5                    # Good depth
      size_multiplier: 1.2             # Pyramid sizing
      price_deviation_percent: 1.0     # Balanced gaps

Aggressive (High Risk/Reward)

MarketWatch:
  AverageMovementPercent: 0.8          # More alerts
  AverageMovementEmergencyClose: 0.4   # Quicker protection
  EmergencyCloseMinHoldTime: 10        # Shorter hold time
  LockPercent: 0.2                     # Sensitive locking

  AutoTrade:
    Enabled: true
    Threshold: 1.5                     # Lower threshold
    Direction: "Both"
    InitialAmount: 200                 # Larger positions
    MaximumHoldTime: 240               # 4-hour max (more room)

    StopLoss:
      Enabled: true
      StopLossPercent: 5               # Looser stop-loss

    DCASettings:
      enabled: true
      max_orders: 7                    # More DCA levels
      size_multiplier: 1.5             # Aggressive pyramid
      price_deviation_percent: 0.8     # Tighter gaps

Scalping Strategy

MarketWatch:
  Candles: 5                           # Faster response (5 min)
  AverageMovementPercent: 0.8
  AverageMovementEmergencyClose: 0.5
  EmergencyCloseMinHoldTime: 5         # Very short holds
  LockPercent: 0.2

  AutoTrade:
    Enabled: true
    Threshold: 1.5
    Direction: "Both"
    InitialAmount: 50                  # Smaller, frequent
    MaximumHoldTime: 30                # 30-min max (scalping)

    StopLoss:
      Enabled: true
      StopLossPercent: 2               # Tight stop

    DCASettings:
      enabled: false                   # No DCA for scalping

Swing Trading Strategy

MarketWatch:
  Candles: 15                          # Slower, smoother (15 min)
  AverageMovementPercent: 2.0
  AverageMovementEmergencyClose: 1.0
  EmergencyCloseMinHoldTime: 120       # 2 hours minimum
  LockPercent: 0.5

  AutoTrade:
    Enabled: true
    Threshold: 3.5                     # Only major events
    Direction: "Both"
    InitialAmount: 500                 # Larger positions
    MaximumHoldTime: 1440              # 24-hour max

    StopLoss:
      Enabled: true
      StopLossPercent: 6               # Wider stop

    DCASettings:
      enabled: true
      max_orders: 5
      size_multiplier: 1.2
      price_deviation_percent: 2.0     # Wider gaps

πŸ“Š Capital Requirements & Risk

Maximum Exposure Calculation

Configuration:
  InitialAmount: 100
  max_orders: 5
  size_multiplier: 1.2
  Symbols: 3 (BTC, ETH, SOL)

Per Symbol:

Order 1: $100
Order 2: $100 Γ— 1.2 = $120
Order 3: $120 Γ— 1.2 = $144
Order 4: $144 Γ— 1.2 = $173
Order 5: $173 Γ— 1.2 = $208
Total per symbol: $745

All Symbols:

3 symbols Γ— $745 = $2,235 maximum per event

Multiple Events:

2 simultaneous events: $4,470
3 simultaneous events: $6,705

Recommended capital: $10,000-15,000
(allows 4-6 simultaneous events + reserve)

Risk Per Event

With Stop-Loss at 4%:
β”œβ”€ Capital deployed: $745 per symbol
β”œβ”€ Max loss (if stopped): $745 Γ— 4% Γ— 5 (leverage) = $149
└─ Total max loss (3 symbols): ~$447

Without Stop-Loss (liquidation):
└─ Could lose entire $2,235 πŸ’€

Stop-loss saves: $1,788 per bad event! βœ…

πŸ“ˆ Expected Performance (Updated with DCA)

Based on Different Crash Depths:

Quick Reversal (-2% to -3%, 70% of events)

Movement: -2% β†’ +1.5% (3.5% swing)
Capital: $300 (initial only, no DCA triggered)
Leverage: 5x
Position value: $1,500

Profit: $1,500 Γ— 3.5% = $52.50
Time: 5-15 minutes
Frequency: 2-3 per week

Weekly: 2.5 Γ— $52.50 = $131
Monthly: $525
Yearly: $6,300

Medium Crash with DCA (-4% to -6%, 25% of events)

Movement: -5% β†’ +2% (7% swing from average)
Initial: $300 (5x) = $1,500
DCA 1-2: $420 (spot) = $420
Total position value: $1,920
Average entry: -4%

Leverage profit: $1,500 Γ— 9% = $135
Spot profit: $420 Γ— 7% = $29
Total: $164

Frequency: 1 per week
Monthly: 4 Γ— $164 = $656
Yearly: $7,872

Deep Crash with Full DCA (-7% to -10%, 5% of events)

Movement: -8% β†’ +3% (11% swing from average)
Initial: $300 (5x) = $1,500
Full DCA: $1,045 (spot)
Total position value: $2,545
Average entry: -5%

Leverage profit: $1,500 Γ— 14% = $210
Spot profit: $1,045 Γ— 11% = $115
Total: $325

Frequency: 2 per month
Monthly: 2 Γ— $325 = $650
Yearly: $7,800

Total Annual Projection:

Conservative estimate with 5x leverage:
β”œβ”€ Quick reversals: $6,300
β”œβ”€ Medium crashes: $7,872
β”œβ”€ Deep crashes: $7,800
└─ Total: ~$21,972 per year πŸš€

Starting capital: $10,000
ROI: ~220% annually

Accounting for losses (stop-loss hits):
β”œβ”€ Gross profit: $21,972
β”œβ”€ Stop-loss losses: -$2,500 (estimated 10% of events)
└─ Net profit: ~$19,472 (195% ROI)

⚠️ Important Warnings

1. Auto-Trade Risk Management

Capital Requirements

Never allocate more than 20% of trading capital per event

Example:
β”œβ”€ Total capital: $10,000
β”œβ”€ Max per event: $2,000
β”œβ”€ Your max exposure: $2,235
└─ Status: ⚠️ Slightly over, reduce to 2 symbols or smaller amounts

Stop-Loss is MANDATORY

# ❌ DANGEROUS
StopLoss:
  Enabled: false

# βœ… SAFE
StopLoss:
  Enabled: true
  StopLossPercent: 4

Why: Without stop-loss, a -10% crash could liquidate your entire position with 5x leverage.

Maximum Hold Time Protection

Without max hold time:
└─ Position could be held indefinitely
└─ Capital locked in losing trades
└─ Miss other opportunities

With max hold time (180 min):
└─ Forces evaluation every 3 hours
└─ Frees capital for better opportunities
└─ Prevents emotional holding

2. DCA Capital Management

With aggressive DCA (7 orders, 1.5x multiplier):
Total capital needed per symbol: ~$1,600
Total for 3 symbols: ~$4,800

If you only have $5,000:
└─ One bad event could use 96% of capital
└─ No reserve for other trades
└─ High stress

Recommendation:
└─ Have 3-5x max exposure in total capital
└─ $5,000 capital β†’ max $1,000-1,500 per event

3. Multiple Simultaneous Events

Scenario: Two -3% crashes on same day

Event 1 (10:00 AM): $2,235 deployed
Event 2 (2:00 PM): $2,235 deployed
Total: $4,470 in active positions

If both hit stop-loss:
└─ Loss: ~$894 in one day

If both profit:
└─ Profit: ~$400-600 in one day

4. Leverage Warnings

With 5x Leverage:

Stop-Loss at 4%:
β”œβ”€ Price movement: -4% from average
β”œβ”€ Leveraged loss: -4% Γ— 5 = -20% of position
└─ Actual loss: $745 Γ— 20% = $149 per symbol

Stop-Loss at 10%:
β”œβ”€ Price movement: -10% from average
β”œβ”€ Leveraged loss: -10% Γ— 5 = -50% of position
└─ Actual loss: $745 Γ— 50% = $372 per symbol (DANGEROUS)

Liquidation (approx -20% move):
└─ TOTAL LOSS of entire position πŸ’€

Key Takeaway: The 4% stop-loss with 5x leverage is designed to limit losses to about 20% of deployed capital, well before liquidation.

πŸ”§ Troubleshooting

Auto-Trade Not Triggering

Check:

  1. AutoTrade.Enabled: true
  2. Movement exceeds AutoTrade.Threshold
  3. Direction matches movement (crash requires Long/Both)
  4. Symbols are configured correctly
  5. Check logs for "πŸš€ Auto-trade triggered" messages

Common Issues:

# Issue: Threshold too high
Threshold: 3.0
Actual movement: -2.5%
Solution: Lower to 2.0 or 1.8

# Issue: Wrong direction
Direction: "Long"
Movement: +3% (pump)
Solution: Change to "Both" or "Short"

DCA Not Triggering

Check:

  1. DCASettings.enabled: true
  2. Price has moved price_deviation_percent from last entry
  3. Haven't reached max_orders yet
  4. Check logs for "DCA Entry X triggered"

Example:

Entry 1: $95,000 @ -1.8%
DCA gap: 1.0%
DCA 2 triggers at: $94,050 (1% lower than $95,000)

Current price: $94,500
Status: DCA not triggered yet (only -0.5% from entry)

Stop-Loss Triggering Too Early

Symptoms:

All auto-trades closing quickly
Logs show: "🚨 AUTO-TRADE STOP-LOSS TRIGGERED"

Causes & Solutions:

# Cause 1: Stop-loss too tight
StopLossPercent: 2
Average entry: -3%
Triggers at: -5% (too close!)

Solution: Increase to 4-5%

# Cause 2: High leverage amplifies movement
Leverage: 10x
Small -2% move = -20% loss

Solution: Reduce leverage to 5x or lower

Maximum Hold Time Closing Profitable Trades

Symptoms:

Trade showing +5% profit
Age: 181 minutes
Action: Closed anyway
Reason: "Maximum hold time exceeded"

This is NORMAL behavior!

  • Maximum hold time is a safety feature
  • Forces taking profits/losses at regular intervals
  • Prevents emotional holding

If you want longer holds:

# For swing trading
MaximumHoldTime: 1440  # 24 hours

# For no limit (not recommended)
MaximumHoldTime: 0

πŸ“ Best Practices

1. Start Conservative

Week 1: Testing Phase

AutoTrade:
  Enabled: true
  Threshold: 3.0              # High threshold (fewer trades)
  InitialAmount: 25           # Very small amount
  Symbols: ["BTCUSDT"]        # Single symbol only
  MaximumHoldTime: 60         # 1-hour max (quick exit)

  StopLoss:
    StopLossPercent: 3        # Tight stop

  DCASettings:
    enabled: false            # No DCA initially

Week 2-4: If Successful

AutoTrade:
  Threshold: 2.5
  InitialAmount: 50
  Symbols: ["BTCUSDT", "ETHUSDT"]  # Add second symbol
  MaximumHoldTime: 120

  DCASettings:
    enabled: true
    max_orders: 3             # Limited DCA

Month 2+: Scale Up

AutoTrade:
  Threshold: 1.8
  InitialAmount: 100
  Symbols: ["BTCUSDT", "ETHUSDT", "SOLUSDT"]
  MaximumHoldTime: 180

  DCASettings:
    max_orders: 5             # Full DCA

2. Monitor First Week Closely

Daily Checklist:

  • [ ] Review all auto-trade executions
  • [ ] Check if stop-loss levels are appropriate
  • [ ] Verify DCA entries occurred at correct levels
  • [ ] Confirm max hold time is reasonable
  • [ ] Calculate actual profit/loss vs expected
  • [ ] Adjust thresholds if needed

3. Document Your Results

Date: 2026-02-01
Event: Market crash -2.8%

Auto-Trade Execution:
β”œβ”€ Entry: -2.8% @ 10:15 AM
β”œβ”€ DCA 1: -3.8% @ 10:25 AM
β”œβ”€ DCA 2: -4.8% @ 10:35 AM
β”œβ”€ Exit: +1.2% @ 11:30 AM (max hold time)
β”œβ”€ Time held: 75 minutes
β”œβ”€ Capital: $660
└─ Profit: $89

Notes: 
- Max hold time worked well
- Could have gained more if held longer
- But forced exit prevented potential reversal loss

4. Adjust for Market Conditions

Bull Market

Direction: "Long"            # Focus on buying dips
Threshold: 2.0               # More opportunities
MaximumHoldTime: 240         # Hold longer for trends

Bear Market

Direction: "Short"           # Focus on shorting pumps
Threshold: 2.5               # More selective
MaximumHoldTime: 120         # Quick exits

High Volatility Period

Threshold: 2.5               # Be more selective
StopLossPercent: 3           # Tighter stops
max_orders: 3                # Less DCA

Low Volatility Period

Threshold: 1.5               # Capture smaller moves
StopLossPercent: 5           # Wider stops
max_orders: 5                # More DCA opportunities

5. Regular Reviews

Weekly:

  • Win rate of auto-trades
  • Average profit per trade
  • Stop-loss hit rate
  • Max hold time effectiveness
  • DCA performance (how often filled, ROI)

Monthly:

  • Which symbols perform best
  • Optimal threshold level
  • Best time of day for auto-trades
  • Capital efficiency
  • Strategy adjustments needed

Quarterly:

  • Overall ROI
  • Risk-adjusted returns
  • Compare vs manual trading
  • Refine configuration
  • Update strategy document

πŸŽ“ Advanced Tips

1. Time-Based Adjustments

# Asian Session (Lower volatility)
AutoTrade:
  Threshold: 1.5
  MaximumHoldTime: 240

# US Session (Higher volatility)
AutoTrade:
  Threshold: 2.0
  MaximumHoldTime: 120

2. Symbol-Specific Settings (Future Feature)

# Concept for future implementation
AutoTrade:
  SymbolSettings:
    BTCUSDT:
      InitialAmount: 150      # Larger for BTC
      StopLossPercent: 4
    SOLUSDT:
      InitialAmount: 75       # Smaller for altcoins
      StopLossPercent: 5      # Wider stop (more volatile)

3. Correlation Management

Don't auto-trade highly correlated pairs simultaneously:

Bad: BTC, ETH, BNB all at once (highly correlated)
└─ If BTC crashes, all three crash together
└─ All positions hit stop-loss
└─ 3x the loss

Better: BTC, SOL, MATIC (less correlated)
└─ Diversification helps

4. Volatility Regime Detection

Calculate recent average movement:
β”œβ”€ Last 24h avg: 0.8%
β”œβ”€ Current threshold: 1.8%
└─ Ratio: 2.25x normal volatility

If market is unusually calm:
└─ Consider lowering threshold temporarily

If market is unusually volatile:
└─ Consider raising threshold
└─ Tighten stop-loss
└─ Reduce leverage

πŸ“ž Support & Feedback

Log Levels for Debugging

Level       Purpose
────────────────────────────────────
info        Normal operations
debug       Detailed flow
warn        Potential issues
error       Failures and emergencies

Important Log Messages

# Auto-Trade Execution
πŸš€ Auto-trade triggered at -2.8%
πŸ“ Placing LONG orders (buying the dip)

# DCA Triggers
πŸ’ͺ DCA Entry 2 triggered @ -3.8%
πŸ”₯ DCA Entry 3 triggered @ -4.8%

# Stop-Loss
🚨 AUTO-TRADE STOP-LOSS TRIGGERED!
current_pnl=-4.50, stop_loss_threshold=-4.00

# Max Hold Time
🚨 AUTO-TRADE MAX HOLD TIME EXCEEDED - Force closing
trade_age=185, max_hold=180, current_pnl=+1.20

# Protection
⏰ Emergency close skipped - minimum hold time not met
βœ… Auto-trade within max hold time limit

When Reporting Issues Include:

  1. Full Market Watch configuration
  2. Relevant log excerpts with timestamps
  3. Market conditions at time of issue
  4. Expected vs actual behavior
  5. Symbol and specific trade details
  6. Screenshots of positions/orders

πŸš€ Quick Start Checklist

Phase 1: Setup (Day 1)

  • [ ] Copy configuration example
  • [ ] Set Enabled: true
  • [ ] Configure 3-5 monitor symbols
  • [ ] Set conservative thresholds
  • [ ] Configure AutoTrade with 1 symbol, $25
  • [ ] Enable stop-loss (4%)
  • [ ] Set maximum hold time (60 min)
  • [ ] Disable DCA initially

Phase 2: Initial Testing (Week 1)

  • [ ] Test alerts with Telegram/Discord
  • [ ] Verify emergency close works
  • [ ] Observe lock/unlock behavior
  • [ ] Wait for first auto-trade event
  • [ ] Verify stop-loss triggers correctly
  • [ ] Confirm max hold time works
  • [ ] Review first trade results

Phase 3: Enable DCA (Week 2)

  • [ ] Enable DCA with max_orders: 3
  • [ ] Set price_deviation: 1.0%
  • [ ] Monitor DCA triggering
  • [ ] Verify average entry calculation
  • [ ] Check stop-loss with DCA positions
  • [ ] Evaluate profitability

Phase 4: Scale Up (Month 2+)

  • [ ] Increase InitialAmount gradually
  • [ ] Add more symbols (up to 3)
  • [ ] Increase max_orders to 5
  • [ ] Optimize thresholds based on data
  • [ ] Fine-tune hold times
  • [ ] Maximize capital efficiency

πŸ“ Summary

What Market Watch Does:

βœ… Monitors market for extreme volatility (crashes/pumps)
βœ… Alerts you via Telegram/Discord
βœ… Protects existing positions (emergency close)
βœ… Prevents bad entries (lock feature)
βœ… Captures opportunities (auto-trade)
βœ… Averages down intelligently (DCA)
βœ… Protects capital (stop-loss)
βœ… Forces discipline (max hold time)

πŸ†• Key Enhancements in v2.0:

  1. Built-in DCA - Automatically average down on continued crashes
  2. Custom Stop-Loss - Auto-trade specific protection (4% from average)
  3. Maximum Hold Time - Time-based exits prevent indefinite holding
  4. Better Capital Management - Clear risk limits per event
  5. Enhanced Logging - Detailed information for debugging

Success Formula:

1. Start small ($25-50 per symbol)
2. Test thoroughly (1-2 weeks)
3. Monitor closely (daily reviews)
4. Scale gradually (weekly adjustments)
5. Document everything (track performance)
6. Adapt to market (change with conditions)

Your system can now turn -3% crashes into +5% profits while protecting you from -10% disasters! 🎯

Last Updated: February 2026
Version: 2.0 (Enhanced Auto-Trade with DCA, Stop-Loss, and Max Hold Time)

Happy Trading! πŸš€πŸ“ˆ

πŸ“Ž Related Topics