Telegram-Benachrichtigungen

WheelTrading kann Ihnen bei wichtigen Order- und Gateway-Ereignissen eine kurze Telegram-Nachricht schicken – kostenlos, latenzarm und ohne zusaetzliche App. Die Benachrichtigungen sind reine Status-Pushes: sie loesen keine Orders aus und enthalten keine sensiblen Kontodaten ausser Symbol, Strike und Stueckzahl.

Was Sie brauchen

<a id="bot-anlegen"></a>

  1. Einen Telegram-Account.
  2. Einen eigenen Bot ueber @BotFather in Telegram anlegen

(/newbot) – Sie erhalten einen Bot-Token.

  1. Den Bot in Telegram einmal anschreiben (/start), damit Telegram Ihnen

eine Chat-ID vergibt. Die Chat-ID finden Sie z.B. ueber @userinfobot oder die API https://api.telegram.org/bot<token>/getUpdates.

Beides tragen Sie im WebApp-Profil unter Einstellungen ▸ Benachrichtigungen ein. Beide Werte werden verschluesselt gespeichert (Fernet/AES) – wir koennen sie selbst nicht im Klartext lesen.

Welche Events Sie bekommen

Die WebApp pusht Ihnen genau die Ereignisse, bei denen Sie normalerweise nicht selbst am Bildschirm sitzen:

EventWann
FILLEDOrder vollstaendig ausgefuehrt (mit Fill-Preis falls bekannt)
PARTIAL FILLTeil-Ausfuehrung
REJECTEDBroker hat die Order abgelehnt (mit Grund)
ASSIGNEDOption wurde Ihnen/gegen Sie zugeteilt
EXPIRED (worthless)Option ist wertlos verfallen
AUTO-CANCEL (3 Tage)3-Tage-Cancel hat eine offene Order automatisch verworfen
CLEANUP FAILED3-Tage-Cancel scheiterte (z.B. Gateway weg) – Retry laeuft
BROKER NO LONGER OPENBroker meldet die Order nicht mehr (manuell gecancelt?)
IBKR-Gateway laeuft abRestzeit Ihrer IBKR-Session < 4 Stunden
IBKR-Gateway Auth verlorenGateway laeuft, ist aber nicht mehr authentifiziert
IBKR-Wartungsfenster aktivIBKR meldet eine Wartung – Login ist temporaer nicht moeglich
IBKR-Wartung beendetWartung vorbei – bitte in der WebApp neu anmelden (2FA)

Gateway-Warnungen sind so getaktet, dass Sie maximal alle 4 Stunden eine Meldung bekommen – das spammt Sie nicht zu, gibt Ihnen aber genug Vorlauf, um vor Ablauf neu zu authentifizieren (2FA-Code in der WebApp eingeben).

Waehrend eines offiziellen IBKR-Wartungsfensters unterdruecken wir die generische Auth verloren-Nachricht und schicken stattdessen genau zwei Pushes: einen beim Start der Wartung und einen beim Ende (als Erinnerung, dass Sie sich jetzt wieder anmelden koennen). So wissen Sie sofort, ob das Problem bei Ihnen liegt oder global IBKR-seitig ist.

Pro Account ein- und ausschaltbar

In den Strategie-Einstellungen pro IBKR-Account koennen Sie den Schalter telegram_notify_enabled setzen. Standard: aus – Sie muessen ihn aktiv einschalten, sobald Sie Bot-Token + Chat-ID hinterlegt haben.

  • Schalter aus: kein Event wird verschickt, selbst wenn Bot-Token

vorhanden ist.

  • Schalter an: alle obigen Events werden geschickt.
  • Adopted Orders (manuell in Lynx aufgegeben und vom System

uebernommen) haben keinen Account-Bezug; sie kommen auch ohne Account-Flag, solange Bot-Token + Chat-ID gesetzt sind.

Earnings-Alerts (NEU)

Zusaetzlich gibt es das Flag telegram_notify_earnings_enabled. Wenn aktiv, sendet der Server taeglich um 07:30 UTC eine Push-Nachricht fuer jedes Symbol im Depot (Aktien oder offene Optionen), das in 7, 3, 1 oder 0 Tagen Earnings hat. Pro (Symbol + Datum + Distanz) genau ein Versand – beim naechsten Tick wird dasselbe Event nicht erneut gefeuert. Datenquelle: next_earnings_date aus dem Fundamentals-Pool (yfinance, nightly refresh).

Plan-Hinweise

  • Free: Bot-Token kann eingetragen werden, aber Notifications sind

deaktiviert. Sie sehen alle Status-Aenderungen in der WebApp.

  • Basic und hoeher: alle Events aktiv.

Beispiel-Nachricht

✅ FILLED
AAPL PUT 180 @ 2026-06-20
Qty: 2 @ $1.25
Fill: $1.23

Was passiert bei Telegram-Ausfall?

Der Notifier ist best-effort: schlaegt das Senden fehl (Netzwerk, Token revoked, Chat-ID falsch), wird das Ereignis nur geloggt. Die Order-Logik selbst laeuft unabhaengig davon weiter – Ihr Trade ist nie vom Telegram-Status abhaengig.