Place-Order-Trading-Bot/DRAWDOWN_PROTECTION_SETUP.md

🛡️ Drawdown Protection - Installation & Usage

Was macht Drawdown Protection?

Das System pausiert automatisch den Trading Bot, wenn:

• ✅ Tagesverlust $100 überschreitet
• ✅ Wochenverlust $300 überschreitet
• ✅ Monatsverlust $800 überschreitet
• ✅ 5 Verluste hintereinander auftreten

Vorteil: Schützt dein Konto vor Overtrading in schlechten Marktphasen!

---

🚀 Installation (im Notebook)

Schritt 1: Nach Infrastructure Setup (Cell ~8)

Füge eine neue Cell hinzu:

# ==========================================
# DRAWDOWN PROTECTION SETUP
# ==========================================

from drawdown_protection import DrawdownProtection, create_protected_trading_check, print_protection_status

print("🛡️ Initializing Drawdown Protection...")

# Erstelle Drawdown Protection
drawdown_protection = DrawdownProtection(
    database=infra.db,
    telegram=infra.telegram,
    max_daily_loss=100,      # $100 pro Tag
    max_weekly_loss=300,     # $300 pro Woche
    max_monthly_loss=800,    # $800 pro Monat
    max_consecutive_losses=5,
    cooldown_hours=24        # 24h Pause nach Limit-Trigger
)

print("✅ Drawdown Protection aktiviert!")
print(f"   Max Daily Loss: ${drawdown_protection.max_daily_loss}")
print(f"   Max Weekly Loss: ${drawdown_protection.max_weekly_loss}")
print(f"   Max Monthly Loss: ${drawdown_protection.max_monthly_loss}")
print(f"   Max Consecutive Losses: {drawdown_protection.max_consecutive_losses}")
print(f"   Cooldown: {drawdown_protection.cooldown_hours} hours")

Schritt 2: Trading Check Wrapping (NACH Session Filter Setup)

WICHTIG: Diese Cell muss NACH dem Session Filter Setup kommen!

Ersetze oder füge hinzu:

# ==========================================
# PROTECTED TRADING CHECK
# ==========================================

# Wrapper um trading_check (fügt Drawdown Protection hinzu)
original_trading_check = trading_check
trading_check = create_protected_trading_check(infra, original_trading_check)

print("✅ Trading Check ist jetzt geschützt durch Drawdown Protection!")
print("   Bot wird automatisch pausiert bei:")
print("   • Tagesverlust > $100")
print("   • Wochenverlust > $300")
print("   • Monatsverlust > $800")
print("   • 5 Verluste in Folge")

Schritt 3: Status Check (Optional - neue Cell)

# ==========================================
# DRAWDOWN PROTECTION STATUS
# ==========================================

print_protection_status(drawdown_protection)

---

✅ Verifikation

Nach Notebook Restart (Kernel → Restart & Run All):

Test 1: Protection ist aktiv

# Sollte ausgeben:
can_trade, reason = drawdown_protection.can_trade()
print(f"Can trade: {can_trade}, Reason: {reason}")
# Erwartung: Can trade: True, Reason: OK

Test 2: Status anzeigen

print_protection_status(drawdown_protection)
# Sollte aktuellen Status zeigen

Test 3: Trading Check läuft

# Führe manuell aus:
trading_check()
# Sollte normal funktionieren (wenn Limits nicht erreicht)

---

🎯 Wie funktioniert es?

Automatischer Schutz:

Szenario 1: Tagesverlust > $100

1. Bot macht $100 Verlust an einem Tag
2. Drawdown Protection erkennt Limit
3. Trading wird pausiert für 24h
4. Telegram Notification: "🛑 Trading paused - Daily loss limit"
5. Nach 24h: Automatische Fortsetzung

Szenario 2: 5 Verluste in Folge

1. Bot hat 5 losing trades hintereinander
2. Protection pausiert Trading für 24h
3. Telegram: "🛑 Too many consecutive losses"
4. Zeit zum Review der Strategie

Szenario 3: Wochenverlust > $300

1. Kumulierter Verlust diese Woche > $300
2. Pause für 48h (2x cooldown)
3. Zeit für ausführliche Analyse

---

🔧 Konfiguration anpassen

Limits ändern:

# Konservativer (weniger Risk):
drawdown_protection = DrawdownProtection(
    database=infra.db,
    telegram=infra.telegram,
    max_daily_loss=50,       # $50/Tag
    max_weekly_loss=150,     # $150/Woche
    max_monthly_loss=400,    # $400/Monat
    max_consecutive_losses=3,
    cooldown_hours=24
)

# Aggressiver (mehr Risk):
drawdown_protection = DrawdownProtection(
    database=infra.db,
    telegram=infra.telegram,
    max_daily_loss=200,      # $200/Tag
    max_weekly_loss=500,     # $500/Woche
    max_monthly_loss=1500,   # $1500/Monat
    max_consecutive_losses=7,
    cooldown_hours=12
)

Empfohlene Settings nach Account Size:

Account	Daily	Weekly	Monthly	Consec
$1,000	$20	$60	$150	3
$5,000	$100	$300	$800	5
$10,000	$200	$600	$1,600	5
$50,000	$500	$1,500	$4,000	7

Faustregel: Max Daily Loss = 2% vom Account

---

🎮 Manuelle Kontrolle

Trading manuell pausieren:

# In Jupyter Notebook Cell:
drawdown_protection.force_pause("Manual review needed", hours=12)

Telegram Notification:

🛑 TRADING PAUSED
Reason: Manual review needed
Duration: 12 hours
Resume at: 2025-12-06 20:00

Trading manuell fortsetzen:

drawdown_protection.force_resume()

Telegram Notification:

✅ TRADING RESUMED
Previous pause reason: Manual review needed
Time: 2025-12-06 08:00

---

📊 Status überwachen

Im Notebook:

# Schneller Check:
print_protection_status(drawdown_protection)

Ausgabe:

======================================================================
🛡️ DRAWDOWN PROTECTION STATUS
======================================================================

✅ Trading ALLOWED

📊 Current Losses:
   Daily:  $45.20 / $100.00
   Weekly: $123.50 / $300.00
   Monthly: $456.80 / $800.00

📉 Consecutive Losses: 2 / 5
======================================================================

Programmatisch:

status = drawdown_protection.get_status()

print(f"Trading allowed: {status['trading_allowed']}")
print(f"Daily loss: ${status['daily_loss']:.2f}")
print(f"Consecutive losses: {status['consecutive_losses']}")

---

⚠️ Was passiert bei Pause?

Während einer Pause:

1. Kein neuer Entry:

   • can_trade() gibt False zurück
   • Trading Check wird übersprungen
   • Keine neuen Positionen

2. Offene Positionen:

   • ✅ Bleiben offen
   • ✅ Position Monitor läuft weiter
   • ✅ Exits werden normal tracked
   • ✅ SL/TP funktionieren

3. Notifications:

   • ✅ Telegram Alert bei Pause
   • ✅ Telegram Alert bei Resume
   • ✅ Logs in Jupyter

Nach Pause-Ende:

• ✅ Trading automatisch fortgesetzt
• ✅ Neue Entries möglich
• ✅ Normal Operation

---

🔍 Troubleshooting

Problem 1: Protection blockiert immer

Check:

status = drawdown_protection.get_status()
print(status)

Lösung: Limits zu niedrig? → Erhöhe max_daily_loss

Problem 2: Protection greift nicht

Check:

# Ist Protection integriert?
print(hasattr(trading_check, 'protection'))
# Sollte True sein

Lösung: Stelle sicher dass create_protected_trading_check() aufgerufen wurde

Problem 3: Falsche Verlust-Berechnung

Check:

daily_loss = drawdown_protection._get_loss_today()
print(f"Daily loss: ${daily_loss:.2f}")

Lösung: Prüfe ob Exit-Daten in DB korrekt sind

---

💡 Best Practices

DO:

• ✅ Setze Limits auf ~2% vom Account (Daily)
• ✅ Überwache Status täglich
• ✅ Nutze manuell Pause bei Unsicherheit
• ✅ Review nach automatischer Pause

DON'T:

• ❌ Limits zu hoch (kein Schutz)
• ❌ Limits zu niedrig (zu viele Pausen)
• ❌ Manuell Resume ohne Analyse
• ❌ Ignoriere Pause-Notifications

---

📈 Integration mit Dashboard

Das Drawdown Protection Status kann ins Dashboard integriert werden:

# In trading_dashboard.py (optional):
if hasattr(trading_check, 'protection'):
    status = trading_check.protection.get_status()

    if not status['trading_allowed']:
        st.error(f"🛑 Trading Paused: {status['pause_reason']}")
    else:
        st.success("✅ Trading Active")

    # Progress bars
    st.progress(status['daily_loss'] / status['daily_limit'])
    st.caption(f"Daily: ${status['daily_loss']:.2f} / ${status['daily_limit']:.2f}")

---

✅ Zusammenfassung

Was hast du jetzt:

• ✅ Automatischer Schutz vor übermäßigen Verlusten
• ✅ Multi-Level Limits (Daily/Weekly/Monthly)
• ✅ Consecutive Loss Protection
• ✅ Telegram Notifications
• ✅ Manuelle Kontrolle
• ✅ Automatisches Resume

Deployment:

1. Upload drawdown_protection.py auf VPS
2. Füge 2-3 Cells ins Notebook ein
3. Restart Notebook
4. Fertig! 🎉

Nächste Schritte:

• Teste mit ersten Trades
• Überwache Status
• Passe Limits nach Bedarf an

---

Status: ✅ Ready for Production!