Cooldown Manager
Verhindert hektische oder technisch unsichere Wiedereinstiege, indem neue Trades nach Stop-Loss, Verlust, API-Fehler oder manueller Sperre für eine klar definierte Zeit blockiert werden.
Für Betreiber und Entwickler von Python-Trading-Bots, die automatische Wiedereinstiege nach Stop-Loss, Verlusten oder technischen Störungen kontrollieren möchten, ohne ihre bestehende Entry-Strategie umzubauen.
Welches Problem löst das Modul?
Nach einem Stop-Loss, einem Verlust oder einem technischen Fehler kann ein Bot schon beim nächsten Signal wieder einsteigen. Dadurch können schnelle Verlustserien, doppelte Orders oder neue Trades entstehen, obwohl der vorherige Vorfall noch nicht sauber verarbeitet wurde. Cooldown Manager startet nach solchen Ereignissen automatisch eine festgelegte Handelspause und behält sie auch nach einem Neustart. Je nach Einstellung pausiert das gesamte Konto, eine Strategie, ein Symbol oder nur eine bestimmte Kombination. Erst wenn die Pause wirklich abgelaufen ist, werden neue Entries wieder freigegeben.
Für welche Börsen ist es geeignet?
- Exchange-unabhängig, weil das Modul keine Orders anlegt, ändert oder storniert
- Einsetzbar mit Bitget, Binance, Bybit, OKX und anderen Börsen, sofern der Bot bestätigte Ereignisse liefert
- Kompatibel mit One-way- und Hedge-Bots, da die Sperre über frei definierte Keys gesteuert wird
- Kann konto-, strategie-, symbol- oder positionsbezogen integriert werden
- Kein direkter Exchange-Zugriff und deshalb keine API-Schlüssel im Modul erforderlich
Ein neuer Entry wird erst zugelassen, wenn die Sicherheitspause wirklich beendet ist.
Das Modul erhält ein eindeutiges Ereignis, speichert Grund, Startzeit und Sperrfrist und prüft unmittelbar vor jedem neuen Entry, ob der gewählte Bereich noch blockiert ist. Doppelte Verarbeitung desselben Ereignisses verlängert die Pause nicht mehrfach. Ein neues kürzeres Ereignis kann eine bereits stärkere Sperre niemals verkürzen. Mit der persistenten Variante bleibt eine aktive Pause auch nach einem Bot-Neustart erhalten.
- 01Bestätigten Stop-, Verlust-, Fehler- oder manuellen Vorfall mit eindeutiger Ereignis-ID übernehmen
- 02Passenden Sperrbereich und konfigurierte Pausendauer bestimmen
- 03Aktive Sperre idempotent speichern, ohne eine stärkere bestehende Pause zu verkürzen
- 04Unmittelbar vor jedem neuen Entry den identischen Sperrbereich prüfen
- 05Entry während der Pause mit Grund, Endzeit und Restdauer blockieren
- 06Nach Ablauf automatisch freigeben oder nach bewusster Betreiberentscheidung manuell löschen
Was das Modul technisch übernimmt
- Getrennte Pausenzeiten für Stop-Loss, Verlust, technischen Fehler und manuelle Sperre
- Frei wählbare Sperrbereiche für Konto, Bot, Strategie, Symbol oder kombinierte Schlüssel
- Persistente Ereignisbelege verhindern doppelte Verlängerung nach späteren Events, Ablauf oder Neustart
- Eine bereits längere aktive Pause wird durch ein kürzeres Folgeereignis niemals abgeschwächt
- Automatische Freigabe exakt nach Ablauf der gespeicherten Sperrfrist
- Bewusste manuelle Freigabe über eine eindeutige Schnittstelle
- Speicherinterner Betrieb für Tests und atomare JSON-Persistenz für produktive Einzelprozesse
- Timezone-sichere Zeitberechnung mit UTC und klarer Restzeitanzeige
- Strukturierte Entscheidung mit Grund, Endzeit, Restsekunden und Ereignis-ID
- Prozessinterne Sperren gegen parallele Zustandsänderungen desselben Bereichs
Was Sie nach dem Kauf erhalten
- Versioniertes Python-Paket 1.0.1 mit vollständig typisierter öffentlicher API
- Cooldown-Engine mit Trigger-, Check- und manueller Clear-Funktion
- Memory-Store und atomarer JSON-Store für Neustart-Persistenz
- Vollständige Einbau-, Konfigurations-, Betriebs- und Fehlerbehebungsanleitung auf Deutsch
- Praxisbeispiele für Konto-, Strategie-, Symbol- und kombinierte Sperren
- 18 automatisierte Tests für Ablauf, A-B-A-Idempotenz, Scope-Trennung, Verlängerung, Neustart, Legacy-State und Eingabefehler
- Reproduzierbarer Wheel- und Source-Paket-Build mit CI-Diagnoseartefakten, Lizenz und Changelog
Technische Voraussetzungen
- Python 3.11 oder neuer
- Ein eindeutiger und im Bot konsistent verwendeter Sperrschlüssel
- Eindeutige Ereignis-ID für jeden bestätigten Stop-, Verlust-, Fehler- oder manuellen Vorfall
- Ein Check unmittelbar vor der tatsächlichen Entry-Order
- Schreibbares persistentes Verzeichnis bei Verwendung des JSON-Stores
- Abnahmetest im Testnet oder in einer sicheren Bot-Umgebung vor Live-Einsatz
Klare Grenzen
- Keine Handelsstrategie und keine Empfehlung, wie lang eine optimale Pause sein sollte
- Das Modul schließt keine offenen Positionen und verändert weder Stop Loss noch Take Profit
- Eine Pause verhindert nur neue Entries an Stellen, an denen der Bot den Check korrekt integriert hat
- Der JSON-Store ist für einen einzelnen Prozess oder einen koordinierten Single-Writer vorgesehen
- Mehrere unabhängige Hosts benötigen einen gemeinsamen transaktionalen Store hinter derselben Schnittstelle
- Persönliche Strategieanpassung und Integration bleiben separate Leistungen
Was nicht enthalten ist
- Keine automatische Optimierung der Pausenzeit anhand historischer Performance
- Keine Tagesverlust-, Drawdown- oder Exposure-Berechnung
- Keine direkte Exchange- oder Telegram-Anbindung
- Keine automatische Erkennung eines Stop-Loss ohne Ereignis aus dem vorhandenen Bot
- Keine Garantie gegen Verluste oder fehlerhafte Signale nach Ablauf der Pause
Die vollständige Anleitung kommt mit dem Modul.
Die öffentliche Seite erklärt Funktion, Lieferumfang und Grenzen. Nach dem Kauf enthält das Paket den vollständigen Code und jeden Einbauschritt. Falls der vorhandene Bot keinen passenden Order-Adapter besitzt, kann persönliche Integration separat angefragt werden.