Exchange Reconciliation
Gleicht lokale Orders und Positionen fail-closed mit der Exchange ab und plant ausschließlich sichere atomare Korrekturen des lokalen States.
Für Betreiber und Entwickler von Python-Trading-Bots mit persistentem Order-/Positionsstate und mehreren möglichen Fehler- oder Neustartpfaden.
Welches Problem löst das Modul?
Durch Timeouts, unterbrochene Datenströme, Neustarts oder manuelle Änderungen können Bot und Börse unterschiedliche Order- und Positionsstände haben. Daraus entstehen Doppelorders, falsche Stop-Mengen, fehlende Fills oder falsche Ergebniszahlen. Exchange Reconciliation vergleicht die vollständigen Börsendaten mit dem lokalen Zustand und zeigt jede Abweichung nachvollziehbar. Nur sichere Korrekturen werden vorbereitet; unklare oder widersprüchliche Fälle bleiben zur Prüfung gesperrt.
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 vollständige Order-/Positionsadapter integrierbar
- Buy/Sell und Long/Short werden getrennt geprüft
- Der Adapter muss aktive und relevante kürzlich terminale Orders vollständig paginieren
- Jede Exchange-, Konto- und Positionsmodus-Kombination benötigt einen dokumentierten Abnahmetest
Nur vorwärts laufende bestätigte Exchange-Daten dürfen den lokalen State atomar korrigieren.
Das Modul ordnet Orders über Exchange- und Client-ID zu, prüft Status/Fills sowie Positionen und stoppt den Gesamtplan bei Fremdorder, Regression oder Identitätskonflikt.
- 01Orderpfade sperren und lokalen State samt Revision lesen
- 02Orders und Positionen vollständig von der Exchange laden
- 03Identitäten, Status, Fills, Mengen und Chronologie prüfen
- 04Bei Konflikt den gesamten Plan als REVIEW_REQUIRED behandeln
- 05Sichere Actions ausschließlich atomar per Compare-and-swap anwenden
- 06Neue lokale Revision und Exchange-Beobachtungszeit gemeinsam speichern
Was das Modul technisch übernimmt
- Frische-, Zukunfts- und vollständige Pagination-Prüfung
- Monotone Exchange-Beobachtungszeit
- Order-Zuordnung über Exchange-ID und stabile Client-ID
- Erkennung gekreuzter ID-Zuordnungen
- Nur vorwärts laufende Orderstatusübergänge
- Keine Regression bereits bestätigter Fill-Mengen
- Strikte Status-/Fill-Invarianten
- Adoption eigener verlorener Orders nur über reserviertes Präfix
- Fremdorders erzwingen REVIEW_REQUIRED
- Positionsmengen- und Durchschnittsentry-Abgleich
- Standardmäßig keine automatische Adoption neuer Positionen
- Atomare Actions mit expected_local_revision
- Keine Mutation der Exchange durch das Modul
Was Sie nach dem Kauf erhalten
- Versioniertes Python-Paket 1.0.0 mit PEP-561-Typinformationen
- Exchange-neutrale Order-/Positions-Reconciliation-Engine
- Vollständige deutsche Produkt-, Einbau-, Startup-, Betriebs- und Incident-Anleitung
- Beispielkonfiguration und ausführbares Integrationsbeispiel
- 77 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
- Vollständig paginierte aktive und relevante terminale Exchange-Orders
- Vollständige Positionsliste des richtigen Accounts und Kontomodus
- Stabile eindeutige Client-Order-IDs
- Lokale revision und zuletzt verarbeitete Exchange-Zeit
- Atomare Anwendung aller Actions oder keiner Action
- Definierter Incident-Pfad für REVIEW_REQUIRED
Klare Grenzen
- Das Modul ändert nur lokalen State und sendet keine Exchange-Order
- Unvollständige Orderhistorie darf nicht als fehlende Order interpretiert werden
- Fremdorders werden weder automatisch übernommen noch gelöscht
- Neue Positionen werden standardmäßig nicht automatisch adoptiert
- Mehrere Prozesse benötigen gemeinsame transaktionale Revision und Sperre
Was nicht enthalten ist
- Keine Exchange-Ordererstellung, -änderung oder -stornierung
- Keine automatische Auflösung von Fremdorder- oder Identitätskonflikten
- Keine Bereitstellung einer verteilten Datenbank
- Keine persönliche Bot- oder Exchange-Adapter-Integration
- Keine ungeprüfte Universal-Kompatibilität mit jeder API-Version
- 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.