IBKR-Import in ThetaForge einrichten
Einmal die Flex Query bei Interactive Brokers konfigurieren, die Historie importieren und den Tagesimport aktivieren – danach läuft der Import von selbst. Diese Seite zeigt den Ablauf im Überblick; die vollständige, bebilderte Fassung mit allen Klicks verlinkt jeder Abschnitt.
Was Du brauchst
Ein Interactive-Brokers-Konto oder einen IB-basierten Broker wie CapTrader oder Lynx mit Zugriff auf die Account-Management-Oberfläche und deren Flex-Queries. ThetaForge liest Deine Daten ausschließlich lesend über den FlexQuery-Web-Service – ein Zugriff, der niemals Order platzieren kann und Dein Konto zu keinem Zeitpunkt verändert. Zum Ausprobieren ohne eigenes Konto liegt dem Quellcode ein erfundener Demo-Datensatz bei; Dashboard, Depotwert und Tradejournal füllen sich damit sofort, ganz ohne Broker-Anbindung.
Flex Query bei IBKR anlegen
Eine Flex Query ist ein konfigurierbarer Bericht, den IBKR auf Abruf liefert. Im Account Management legst Du unter „Berichte → Flex-Queries" eine neue Kontoumsatz-Flex-Query an und aktivierst darin alle Sektionen, die ThetaForge für vollständige Trades, Cashflows und Kapitalmaßnahmen braucht: Bartransaktionen, Cash-Bericht, Forex-G&V, Kapitalmaßnahmen, offene Positionen, Optionsausübungen, Trades und Transfers. Drei Einstellungen sind dabei Pflicht, sonst bleiben später Spalten leer oder Renditen weichen ab: die Performance Summary muss auf „Yearly" (Kalenderjahr) stehen, in der Trades-Sektion müssen FIFO Realized Profit/Loss und MTM Profit/Loss angehakt sein, und FXRateToBase muss aktiv sein, damit Fremdwährungsbeträge korrekt umgerechnet werden. Als Auslieferformat wählst Du XML.
Der einmalige Aufbau der Flex Query ist der mühsamste Teil der Einrichtung – deshalb gibt es dafür eine bebilderte Schritt-für-Schritt-Anleitung mit allen Klicks und Screenshots: IMPORTANLEITUNG.md im öffentlichen Archiv.
Prüfcode: Sicherheit zuerst
Für den automatischen Abruf erzeugst Du in der Flex-Web-Service-Konfiguration einen Prüfcode (Token). Er wirkt wie ein Passwort und gewährt lesenden API-Zugriff auf Deine Kontodaten – IBKR zeigt ihn nur einmal an, deshalb sofort im Passwortmanager sichern. ThetaForge speichert ihn verschlüsselt (AES-256-GCM) und gibt den Klartext nie wieder aus. Geht er verloren, erzeugst Du in IBKR einfach einen neuen; der alte wird dabei automatisch ungültig.
Historie einmalig importieren
Der Flex-Web-Service liefert nur rund 365 Tage rückwirkend. Ältere Jahre exportierst Du einmalig manuell als XML – pro Kalenderjahr eine Datei – und importierst sie danach in ThetaForge unter „Depot & Import" im Tab „CSV/XML-Import". Beim ersten Import legt ThetaForge die passende Einheit und je erkannter Konto-ID ein eigenes Depot automatisch an; für jede weitere Jahres-Datei erkennt es das bestehende Depot von selbst. Duplikate verhindert der Import über die eindeutige Ausführungs-ID jedes Trades, die Reihenfolge der importierten Jahre spielt also keine Rolle.
Automatischen Tagesimport einrichten
Sind Prüfcode und Query-ID hinterlegt, aktivierst Du im Depot die FlexQuery-API, trägst eine Uhrzeit für den Auto-Import ein und bestätigst die Verbindung. Ab dann holt ThetaForge die Daten des Vortags von selbst – in der Cloud-Variante per Vercel Cron unabhängig davon, ob Dein eigener Rechner läuft, in der Desktop-Variante durch den eingebauten Zeitplaner, solange Docker auf Deinem Rechner läuft. Verpasste Tage werden beim nächsten Lauf automatisch nachgeholt, weil die Flex Query jeweils einen Zeitraum statt eines einzelnen Tages liefert.
Was danach automatisch läuft
Ab der Einrichtung braucht der Import keine weiteren Klicks mehr: Trades, Prämien, Dividenden, Gebühren, Kapitalmaßnahmen und Transfers kommen täglich herein, Depotwert und Rendite aktualisieren sich von selbst, und Positionen mit mehreren Beinen lassen sich im Tradejournal weiter Strategien zuordnen. Bleibt die Zusammensetzung der Query unverändert, brauchst Du hier nichts weiter zu tun. Änderst Du sie nachträglich (etwa eine neu aktivierte Sektion), empfiehlt sich ein einmaliges Löschen der Tradedaten im Depot und ein erneuter Historien-Import, damit keine Altzeilen mit fehlenden Werten liegen bleiben.
Führst Du mehrere Depots in derselben Einheit, erkennt ThetaForge depotübergreifende Transfers automatisch und verbucht sie als neutrale Umschichtung statt als Ein- oder Auszahlung – Deine Rendite bleibt dadurch sauber. Und wer schon länger mit derselben Query arbeitet: ThetaForge importiert weiterhin auch das ältere CSV-Format über dieselbe Import-Pipeline, für neue Einrichtungen ist XML aber die empfohlene Wahl.