Partial Fill Handler
Partial Fill Handler führt bestätigte Teilfills idempotent zusammen und berechnet jederzeit die tatsächlich noch ungeschützte Positionsmenge.
Für Betreiber und Entwickler von Python-Trading-Bots, die Order-, Fill- und Signalzustände vor Live-Entscheidungen nachvollziehbar und fail-closed absichern möchten.
Welches Problem löst das Modul?
Auch eine nur teilweise ausgeführte Entry-Order erzeugt sofort eine echte offene Position. Wartet der Bot auf die vollständige Ausführung, kann diese Teilposition ohne passenden Stop bleiben. Schützt er dagegen die ursprünglich geplante Gesamtmenge, kann der Stop später zu viel schließen. Partial Fill Handler führt alle bestätigten Teilfills genau einmal zusammen und zeigt jederzeit, wie viel Position tatsächlich offen, bereits geschützt oder noch ungeschützt ist.
Für welche Börsen ist es geeignet?
- Exchange-neutraler Python-Kern ohne direkten Börsenzugriff und ohne API-Schlüssel
- Mit Bitget, Binance, Bybit, OKX und anderen Börsen integrierbar, wenn der Bot normalisierte bestätigte Daten liefert
- Long-, Short-, One-way- und Hedge-Betrieb sind über stabile Scopes und IDs abbildbar
- Exchange-spezifische Status-, Mengen- und Präzisionswerte müssen im Adapter normalisiert werden
- Keine pauschale Plug-and-play-Garantie für jede Börse, API-Version oder Bot-Struktur
Partial Fill Handler: lokale Annahmen reichen nicht als Bestätigung.
Der vorhandene Bot liefert stabile IDs, UTC-Zeitstempel und normalisierte Daten. Das Modul validiert den Zustand und gibt einen strukturierten nächsten Schritt aus. Eine Exchange-Aktion erfolgt erst außerhalb des Moduls durch den Bot.
- 01erwartete Ordermenge und Exchange-Order-ID registrieren
- 02bestätigte Fills mit eindeutiger fill_id persistent übernehmen
- 03Gesamtfill und Restmenge ohne Doppelzählung berechnen
- 04PROTECT_CONFIRMED ausgeben, solange bestätigte Menge noch ungeschützt ist
- 05terminalen Orderstatus erst nach Schutz der bestätigten Menge als COMPLETE behandeln
Was das Modul technisch übernimmt
- erwartete Ordermenge und Exchange-Order-ID registrieren
- bestätigte Fills mit eindeutiger fill_id persistent übernehmen
- Gesamtfill und Restmenge ohne Doppelzählung berechnen
- PROTECT_CONFIRMED ausgeben, solange bestätigte Menge noch ungeschützt ist
- terminalen Orderstatus erst nach Schutz der bestätigten Menge als COMPLETE behandeln
- Fill-Retries sind idempotent; abweichende Wiederholungen blockieren
- Fill- und Schutzmenge können nicht zurückgehen
- Overfill und Schutz über bestätigter Menge werden abgelehnt
- neue Fills nach terminalem State verlangen zuerst Reconciliation
- persistenter State bleibt über Bot-Neustarts erhalten
Was Sie nach dem Kauf erhalten
- Versioniertes Python-Paket 1.0.0 mit vollständig typisierter öffentlicher API und PEP-561-Marker
- Wheel und Source Distribution für Python 3.11 oder neuer
- Ausführbares Integrationsbeispiel und Beispielkonfiguration
- Ausführliche deutsche Kundenanleitung mit Nutzen, Einbau, Betrieb und Fehlerbehebung
- Release-Checkliste und technischer Kontrollbericht
- Automatisierte Tests mit mindestens 95 Prozent Coverage
- Kunden-ZIP mit Wheel, Source, Dokumentation, Beispielen und Lizenz
- SHA-256-Prüfsumme für das erzeugte Kunden-ZIP
Technische Voraussetzungen
- Python 3.11 oder neuer
- stabile und über Neustarts wiederverwendete IDs
- timezone-aware UTC-Zeitstempel
- normalisierte bestätigte Bot- beziehungsweise Exchange-Daten
- Paper-/Sandbox-Abnahme vor Live-Aktivierung
Klare Grenzen
- Das Modul platziert oder ändert keine Stop-Order selbst.
- Nach jedem PROTECT_CONFIRMED muss der Bot den echten Reduce-only-Schutz bestätigen.
- Der JSON-Store ist für einen Prozess/einen Writer vorgesehen.
- Cancel-Entscheidungen für die Restmenge gehören in Order Timeout & Cancel Recovery.
Was nicht enthalten ist
- Keine Handelsstrategie, Signalerzeugung oder Gewinnoptimierung
- Keine Finanzberatung oder Garantie für Ausführung und Ergebnis
- Keine direkte Exchange-, Telegram- oder Datenfeed-Anbindung
- Keine persönliche Integration oder Anpassung an einen konkreten Bot
- Keine neuen Exchange-Adapter außerhalb der dokumentierten Schnittstelle
- Kein Betrieb, Hosting oder Monitoring des Kundenbots
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.