Trade Logger
Protokolliert Entry-Entscheidungen, Orders, Fills, Gebühren, Funding, Schutzereignisse und Exits persistent sowie vollständig idempotent.
Für Betreiber und Entwickler von Python-Trading-Bots, die Trades über Neustarts hinweg technisch nachvollziehbar und für Reports auswertbar dokumentieren möchten.
Welches Problem löst das Modul?
Viele Bots speichern nur eine einfache Ergebniszeile und verlieren dadurch wichtige Details zwischen Signal, Order, Fill, Schutz und Exit. Dann bleibt unklar, warum ein Trade anders gelaufen ist, ob Ereignisse fehlen oder Gebühren und Funding richtig zugeordnet wurden. Trade Logger dokumentiert den vollständigen Lebensweg jedes Trades mit eindeutigen Kennungen und speichert jedes bestätigte Ereignis genau einmal. Dadurch werden Fehler leichter nachvollziehbar und Tagesberichte erhalten eine verlässliche Datengrundlage.
Für welche Börsen ist es geeignet?
- Exchange-unabhängiger Python-Kern ohne direkten Börsenzugriff
- Mit Bitget, Binance, Bybit, OKX und anderen Börsen bei bestätigten Adapter-Events nutzbar
- One-way- und Hedge-Ereignisse über stabile Positions- und Trade-IDs abbildbar
- JSON-Store für einen Prozess oder koordinierten Single-Writer
- Mehrere Hosts benötigen einen gemeinsam transaktionalen Store
Ein Trade wird als bestätigte Ereigniskette statt als einzelne Ergebniszeile dokumentiert.
Der Bot übergibt bestätigte Events mit stabilen IDs. Das Modul validiert typabhängige Pflichtfelder, schreibt atomar und liefert bei identischer Wiederholung ALREADY_RECORDED statt einer Doppelzählung.
- 01Bestätigtes fachliches Ereignis mit stabiler ID übernehmen
- 02Typabhängige Pflichtfelder validieren
- 03Vorhandene Event-ID vollständig vergleichen
- 04Neues Event atomar speichern oder identische Wiederholung bestätigen
- 05Trade-Historie chronologisch für Reporting bereitstellen
- 06Konflikte als Incident behandeln
Was das Modul technisch übernimmt
- Sieben getrennte Eventtypen für Entscheidung, Versand, Fill, Fee, Funding, Exit und Schutz
- Pflichtprüfung für Fill-Menge, Fill-Preis und Order-ID
- Bestätigter Netto-PnL beim Exit
- Stabile Event- und Trade-Identität
- Vollständiger Inhaltsfingerprint gegen widersprüchliche Wiederholungen
- ALREADY_RECORDED ohne Doppelzählung
- Atomare JSON-Persistenz mit fsync und Replace
- Chronologische deterministische Trade-Historie
- Timezone-aware Zeitstempel
- Fail-closed bei beschädigtem oder unlesbarem State
Was Sie nach dem Kauf erhalten
- Versioniertes Python-Paket 1.0.0 mit typisierter API
- Memory-Store und atomarer JSON-Store
- 46 automatisierte Tests mit 100,00 Prozent Branch-Coverage
- Vollständige deutsche Kunden- und Einbauanleitung
- Ausführbares Integrationsbeispiel und Beispielkonfiguration
- Wheel und Source Distribution
- Kunden-ZIP mit SHA-256-Prüfsumme
- Kontrollbericht, Release-Checkliste, Changelog und Lizenz
Technische Voraussetzungen
- Python 3.11 oder neuer
- Stabile Event-, Trade-, Order- und Positions-IDs
- Bestätigte Exchange-Ereignisse und Decimal-Werte
- Timezone-aware Ereigniszeit
- Dauerhafter beschreibbarer State-Pfad
- Testnet-/Demo-Abnahme vor Live-Einsatz
Klare Grenzen
- Keine Orderausführung oder Exchange-Reconciliation
- Keine nachträgliche PnL-Berechnung aus Fills
- Lokaler JSON-Store nicht für unkoordinierte Multi-Host-Schreiber
- Keine revisionssichere WORM-Archivierung
- Vollständigkeit hängt von der Eventquelle ab
- Persönliche Integration bleibt separate Leistung
Was nicht enthalten ist
- Keine Handelsstrategie oder Signalerzeugung
- Keine direkte Exchange-, Telegram- oder Zahlungsanbindung
- Keine Steuer- oder Buchhaltungsberechnung
- Kein zentral betriebener Datenspeicher
- Keine Aufzeichnung geheimer Rohdaten
- Keine Gewinn- oder 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.