Position State Recovery
Stellt lokale Positionen nach Neustart revisionsgebunden aus einem frischen, vollständigen und autoritativen Exchange-Snapshot wieder her.
Für Betreiber und Entwickler zustandsbehafteter Python-Trading-Bots, die nach jedem Neustart den realen Positionszustand sicher rekonstruieren müssen.
Welches Problem löst das Modul?
Nach einem Bot-Absturz oder Neustart können die lokal gespeicherten Positionsdaten veraltet sein. Der Bot glaubt dann vielleicht, eine andere Menge, einen anderen Einstiegspreis oder gar keine Position zu haben, obwohl die Börse etwas anderes zeigt. Position State Recovery lädt einen frischen vollständigen Börsen-Snapshot und stellt den lokalen Zustand kontrolliert wieder her. So arbeitet der Bot nach dem Neustart nicht mit falschen Positions-, Stop- oder Exit-Daten weiter.
Für welche Börsen ist es geeignet?
- Exchange-neutraler Python-Kern ohne direkten Börsenzugriff oder API-Schlüssel
- Mit Bitget, Binance, Bybit, OKX und anderen Börsen über autoritative Positionssnapshots integrierbar
- Long und Short werden als getrennte Identitäten geprüft
- Der Adapter muss Account, Symbol, Positions-ID, Menge, Durchschnittsentry und Vollständigkeit sicher mappen
- Hedge-, One-way-, Classic- und UTA-Modi benötigen jeweils einen dokumentierten Abnahmetest
Die Exchange liefert die reale Position; Chronologie und lokale Revision verhindern Rückwärtsüberschreiben.
Das Modul vergleicht lokalen State und Exchange-Position, erkennt Flat-, Restore-, Close- und Refresh-Fälle und bindet jede Änderung an expected_local_revision.
- 01Trading und Orderpfade für den Scope sperren
- 02Lokalen State samt Revision und letzter Exchange-Zeit lesen
- 03Frischen vollständigen Exchange-Positionssnapshot laden
- 04RecoveryPlan gegen Identität und Chronologie berechnen
- 05Plan ausschließlich per Compare-and-swap atomar anwenden
- 06Danach Orders reconciliieren und Stop-Schutz bestätigen
Was das Modul technisch übernimmt
- Frische-, Zukunfts-, Autoritäts- und Vollständigkeitsprüfung
- Account- und Symbol-Scope-Abgleich
- Long-/Short- und Positions-ID-Konflikterkennung
- Erkennung beidseitig flacher Zustände
- Wiederherstellung lokal fehlender Exchange-Positionen
- Sicheres lokales Schließen nur durch neueren vollständigen Flat-Snapshot
- Mengen- und Durchschnittsentry-Refresh bei gleicher Identität
- Konfigurierbare Decimal-Toleranzen
- Schutz vor älteren Exchange-Snapshots
- Schutz vor widersprüchlichem Replay derselben Snapshot-ID
- expected_local_revision für atomaren Compare-and-swap
- Fail-closed BLOCKED und REVIEW_REQUIRED
Was Sie nach dem Kauf erhalten
- Versioniertes Python-Paket 1.0.0 mit PEP-561-Typinformationen
- Exchange-neutrale Positions-Recovery-Engine
- Vollständige deutsche Produkt-, Einbau-, Startup-, Betriebs- und Fehlerbehebungsanleitung
- Beispielkonfiguration und ausführbares Integrationsbeispiel
- 50 automatisierte Tests mit 100,00 Prozent Branch-Coverage
- Ruff-0.12.12- und Mypy-strict-Qualitätsgates
- Reproduzierbarer Wheel- und Source-Build
- Kunden-ZIP mit SHA-256, Lizenz, Changelog, Checkliste und Kontrollbericht
Technische Voraussetzungen
- Python 3.11 oder neuer
- Autoritativer, vollständig paginierter Exchange-Positionssnapshot
- Stabile Account-, Symbol- und Positions-IDs
- Lokale monotone revision für Compare-and-swap
- Zuletzt verarbeitete Snapshot-ID und Exchange-Beobachtungszeit
- Atomarer lokaler Datenspeicher
- Nachgelagerte Exchange-Reconciliation und Stop-Schutzprüfung
Klare Grenzen
- Das Modul persistiert den RecoveryPlan nicht selbst
- ID- oder Richtungswidersprüche werden bewusst nicht automatisch überschrieben
- Ein Flat-Snapshot gilt nur bei vollständig bestätigter Positionsliste
- Orders und Fills werden in Exchange Reconciliation separat geprüft
- Persönlicher Einbau und Datenbankmigration bleiben separate Leistungen
Was nicht enthalten ist
- Keine Exchange-Ordererstellung, -änderung oder -stornierung
- Keine Strategie-, Signal- oder Positionsgrößenlogik
- Keine automatische Übernahme manueller Fremdpositionen bei Identitätskonflikt
- Keine Bereitstellung eines verteilten transaktionalen Datenspeichers
- Keine ungeprüfte Universal-Kompatibilität mit jeder Kontoart
- Keine Gewinn- oder vollständige Verlustvermeidungsgarantie
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.