Same Candle Block
Same Candle Block reserviert einen Entry pro Scope, Symbol, Timeframe und Kerze und verhindert dadurch ungewollte Mehrfacheinstiege innerhalb derselben Kerze.
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?
Ein Bot scannt den Markt mehrfach und kann dasselbe Signal innerhalb einer Kerze immer wieder erkennen. Bei parallelen Abläufen, Wiederholungen oder einem Neustart können dadurch mehrere echte Orders für denselben geplanten Trade entstehen. Same Candle Block reserviert den ersten Entry eindeutig für diese Strategie, dieses Symbol, diesen Timeframe und diese Kerze. Jeder weitere Versuch in derselben Kerze wird gestoppt, damit aus einem Signal nicht versehentlich mehrere Positionen werden.
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
Same Candle Block: 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.
- 01stabile Entry-ID und exakte Kerzenidentität bilden
- 02persistente Reservierungen unter einer gemeinsamen prozessinternen Sperre laden
- 03Retries derselben Entry-ID als ALREADY_RESERVED zurückgeben
- 04eine zweite Entry-ID für dieselbe Kerze blockieren
- 05Reservierung nach sicherem Orderversand bestätigen oder nur nach bestätigtem Nichtversand freigeben
Was das Modul technisch übernimmt
- stabile Entry-ID und exakte Kerzenidentität bilden
- persistente Reservierungen unter einer gemeinsamen prozessinternen Sperre laden
- Retries derselben Entry-ID als ALREADY_RESERVED zurückgeben
- eine zweite Entry-ID für dieselbe Kerze blockieren
- Reservierung nach sicherem Orderversand bestätigen oder nur nach bestätigtem Nichtversand freigeben
- Prüfung und Reservierung erfolgen atomar innerhalb eines Prozesses
- bestätigte Entries können innerhalb derselben Kerze nicht freigegeben werden
- wiederverwendete IDs mit abweichenden Daten blockieren fail-closed
- JSON-State wird atomar ersetzt und über Neustarts erhalten
- abgeschlossene oder unzulässig zukünftige Kerzen werden abgelehnt
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
- Der JSON-Store ist für einen Prozess beziehungsweise einen Writer vorgesehen.
- Mehrere Hosts benötigen einen gemeinsamen transaktionalen Store oder eine zentrale Entry-Queue.
- Das Modul sendet keine Order und erkennt einen Fill nicht selbst.
- Eine Reservierung darf nur freigegeben werden, wenn die Exchange sicher bestätigt, dass keine Order existiert.
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.