Telegram-Benachrichtigungen

WheelTrading kann dir 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 du brauchst

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

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

(/newbot) – du erhaeltst einen Bot-Token.

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

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

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

Welche Events du bekommst

Die WebApp pusht dir genau die Ereignisse, bei denen du normalerweise nicht selbst am Bildschirm sitzt:

EventWann
FILLEDOrder vollstaendig ausgefuehrt (mit Fill-Preis falls bekannt)
PARTIAL FILLTeil-Ausfuehrung
REJECTEDBroker hat die Order abgelehnt (mit Grund)
ASSIGNEDOption wurde dir/dir gegen 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 deiner 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 du maximal alle 4 Stunden eine Meldung bekommst – das spammt dich nicht zu, gibt dir 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 du dich jetzt wieder anmelden kannst). So weisst du sofort, ob das Problem bei dir liegt oder global IBKR-seitig ist.

Pro Account ein- und ausschaltbar

In den Strategie-Einstellungen pro IBKR-Account kannst du den Schalter telegram_notify_enabled setzen. Standard: aus – du musst ihn aktiv einschalten, sobald du Bot-Token + Chat-ID hinterlegt hast.

  • 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. Du siehst 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 – dein Trade ist nie vom Telegram-Status abhaengig.