Interactive Brokers verbinden
Du brauchst zwei Dinge aus deinem IBKR-Konto: eine Flex-Abfrage (Query-ID) und das Flex-Token (bei IBKR „Prüfcode“ genannt). Beides ist nur lesend. Dauer: etwa 5 Minuten.
1. Im Client Portal einloggen
Die Einrichtung geht nur im IBKR Client Portal im Browser (nicht in der App und nicht in der Trader Workstation). Dort im Menü auf „Berichte“ (oder „Leistung & Berichte“) → „Flex-Abfragen“. Die Schnittstelle heißt bei IBKR nicht „API“, sondern „Flex Web Service“.
2. Die Abfrage anlegen
Beim Abschnitt „Kontoumsatz-Flex-Query“ (auf Englisch „Activity Flex Query“) oben rechts auf das Plus klicken. Dann so einstellen:
| Wo | Was auswählen |
|---|---|
| Name der Abfrage | Frei wählbar, z. B. „Kryptofiskus“ |
| Abschnitt „Trades“ | Aktivieren. Unter „Optionen“ nur „Ausführungen“ (Execution) auswählen. Bei den Feldern am einfachsten „Alle auswählen“. |
| Abschnitt „Offene Positionen“ | Aktivieren (für deine aktuellen Bestände im Dashboard). Optionen: „Zusammenfassung“ bzw. Standard. Felder: „Alle auswählen“. |
| Alle anderen Abschnitte | Nicht nötig, bitte aus lassen. |
| Format | XML (nicht CSV) |
| Zeitraum | Letzte 365 Kalendertage |
| Datumsformat | yyyyMMdd (Standard) |
| Stornierte Trades / Audit-Felder / Währungskurse | Nein (aus) |
Speichern. Die Abfrage steht danach in der Liste, daneben (oder in den Details) siehst du die Query-ID – eine Zahl. Die brauchst du gleich.
Wichtig für uns: Käufe und Verkäufe (Trades) von Aktien, ETFs und Krypto sowie die offenen Positionen. Optionen, Futures, Devisen und Anleihen überspringen wir.
3. Das Token (den „Prüfcode“) holen
Auf derselben Seite gibt es den Kasten „Flex-Web-Service-Konfiguration“. Der „Flex-Web-Service-Status“ muss auf „Aktiviert“ stehen (Kästchen anhaken und speichern). Im selben Kasten steht der „Aktive Prüfcode“ – das ist das Flex-Token, das wir brauchen (in der englischen Oberfläche heißt er „Current Token“). Über „Neuen Prüfcode generieren“ legst du die Gültigkeit fest, von 6 Stunden bis 1 Jahr – nimm 1 Jahr.
Wichtig: Das Feld „Gültig für die IP-Adresse“ leer lassen. Unsere Server haben keine feste Adresse; ist dort eine IP eingetragen, lehnt IBKR unseren Abruf ab.
Der Prüfcode kann nichts handeln, er liest nur die Berichte. Gib ihn trotzdem nur in unser Formular ein, nicht in E-Mails oder Chats. Ist er einmal woanders gelandet, einfach einen neuen generieren: Der alte wird sofort ungültig.
4. Bei Kryptofiskus eintragen
Unter Wallets → Börse/Wallet verbinden → Broker → Interactive Brokers: bei „Flex-Token“ den Prüfcode einfügen und bei „Flex-Query-ID“ die Zahl der Abfrage. Fertig, die erste Synchronisierung startet.
Wenn etwas nicht klappt
- „Token abgelaufen“: Im Client Portal ein neues Token erzeugen und bei uns die Verbindung aktualisieren.
- „Token oder Query-ID ungültig“: Beide noch einmal vergleichen. Die Query-ID ist die Zahl der Abfrage, nicht des Kontos.
- „Kein Abschnitt Trades / Open Positions“: Die Abfrage um den fehlenden Abschnitt ergänzen.
- Ältere Käufe fehlen: Eine Flex-Abfrage reicht höchstens 365 Tage zurück. Ältere Käufe importierst du per CSV (Aktivitätsbericht oder Transaktionsverlauf unter Berichte).
Keine Steuerberatung. Die Bezeichnungen im IBKR-Portal können sich ändern. Offizielle Hilfe von IBKR: Flex Web Service einrichten.