Zur Themenuebersicht

Dividenden & Quellensteuer

WheelTrading.io importiert Dividenden zwei Mal pro Tag automatisch aus IBKR Flex Web Service (Cash-Transactions-Section).

Dividenden-Forecast (/dashboard/dividends)

Eigene Seite mit drei Bloecken:

  • Statistik-Cards: Gesamt-Eingaenge, dieses Jahr (YTD),

letzte 12 Monate, durchschnittlich pro Monat (aus den letzten 12M).

  • Anstehende Dividenden: Joinst aktive Aktienpositionen mit dem

Dividenden-Kalender (yfinance) und schaetzt den Eingang als `stueck * brutto_je_aktie`. Horizont waehlbar (30 / 60 / 90 / 180 / 365 Tage). Summen werden pro Waehrung aggregiert.

  • Top-Zahler (5) plus Tabelle der letzten Eingaenge.

Voraussetzung fuer den Forecast: aktive long_stock Position im Depot und mindestens ein Dividenden-Termin im Kalender (wird vom yfinance- Pool-Refresh nachts gefuellt).

Schnellzugriff: Button "Forecast" im Cockpit-Header.

Welche Typen kommen an

  • DIVIDEND - regulaere Dividendenzahlung (positiv)
  • WITHHOLDING_TAX - Quellensteuer auf Dividenden (negativ)

Idempotenz

Jede Transaktion wird ueber (user_id, ibkr_transaction_id) eindeutig identifiziert. Auch bei mehreren Importen wird jede Zahlung nur einmal gebucht. Es gibt keinen Update-Pfad - die Tabelle ist append-only.

Zeitplan

  • 06:00 UTC und 18:00 UTC pro Tag.
  • Pro User wird eine eigene DB-Session genutzt; Fehler eines Users blocken

andere User nicht.

  • Bei Flex-Fehlern oder Rate-Limit (1 Aufruf je 15 Minuten je Query)

wird der Import einfach beim naechsten Tick erneut versucht.

Konfiguration

Sie brauchen pro User:

  • Flex-Token (in den globalen Einstellungen)
  • Query-ID Dividenden (eigene Query, nur Cash-Transactions)
Wichtig: Token und Query-ID werden verschluesselt gespeichert und niemals geloggt.

Symbol-Spalte

Optionssymbole nach OCC-Norm (z.B. CMCSA 260116P00045000) werden bis zu 40 Zeichen unterstuetzt - so passt jedes US-Listed-Optionssymbol.

Sperrtage in der Strategie

In den Strategie-Einstellungen können Sie Sperrtage rund um Ex-Dividende setzen:

  • Sperrtage Put vor Ex-Dividende - keine neuen Short-Puts.
  • Sperrtage Call vor Ex-Dividende - keine neuen Covered-Calls.
  • Sicherheitstage nach Ex-Dividende - "Ruhefenster" nach dem Termin.