IBKR und CapTrader in Depotlog verbinden

Diese Anleitung führt Dich durch die erste Broker-Verbindung. Nach ~15 Minuten läuft Dein Depot in Depotlog: Trades, Positionen, Cash-Bestände und Multi-Währungs-FX werden alle automatisch im Hintergrund synchronisiert — auch wenn Dein PC ausgeschaltet ist.

⛔ WICHTIG — bitte VOR dem Start lesen Sei während des allerersten Sync NICHT parallel bei IBKR/CapTrader eingeloggt — weder in TWS, noch in IB Gateway, noch im Client Portal / Kunden-Portal in irgendeinem Browser-Tab.

IBKR erlaubt pro User nur eine aktive Session. Wenn Du gleichzeitig eingeloggt bist, schließt IBKR Dein Konto stillschweigend aus der API-Antwort aus und Depotlog importiert keine oder unvollständige Daten. Der Fehler ist nicht offensichtlich — Du siehst nur einen leeren Import.

So machst Du’s richtig:

1. Vor dem Sync: aus TWS/Client-Portal komplett ausloggen (alle Browser-Tabs schließen)
2. 30 Sekunden warten, damit IBKR die Session sauber beendet
3. Ersten Sync in Depotlog starten
4. Danach kannst Du wieder normal bei IBKR einloggen

Wenn Du dauerhaft parallel mit TWS arbeiten willst: dafür gibt es einen Sub-User (nur Leserechte). Das musst Du beim ersten Setup aber noch nicht einrichten — siehe 01 IBKR Sub-User für Flex Web Service wenn Du später umsteigen willst.

Was Du am Ende hast

• ✅ Alle Trades der letzten 365 Tage in Depotlog importiert
• ✅ Offene Positionen mit Cost-Basis, Live-Kurs, Unrealized P&L
• ✅ Cash-Bestände in allen Deinen Konto-Währungen
• ✅ Stündliche Auto-Sync neuer Trades (Mo–Fr während US-Marktzeit)
• ✅ Nichts mehr manuell eintippen für aktive Broker

Voraussetzungen

• Ein aktives IBKR-Konto (Interactive Brokers) oder CapTrader-Konto
• Zugang zum Kunden-Portal (Login-Daten)
• Ca. 15 Minuten Zeit
• Tipp für vorsichtige Tester: Du kannst das Setup zuerst mit einem kostenlosen Papertrading-Konto üben, bevor Du Dein Live-Depot anbindest. Die Schritte sind identisch.

Welchen Broker hast Du?

IBKR (Interactive Brokers direkt): Portal unter ibkr.com → Setup ist nahezu identisch zu CapTrader.

CapTrader: deutscher IBKR-Introducing-Broker unter captrader.com → nutzt die IBKR-Infrastruktur, gleiche Flex-Query-Mechanik.

Diese Anleitung funktioniert für beide — die Screenshots zeigen CapTrader (weil das der häufigere DACH-Fall ist), IBKR-User finden die identischen Menüpunkte in ihrem Portal.

Setup in 5 Schritten

1) Flex Web Service aktivieren

Der “Flex Web Service” ist die offizielle IBKR-Schnittstelle die Depotlog nutzt — kein inoffizieller Scraper, kein Passwort-Speichern, sondern ein von IBKR selbst gebauter API-Zugang für Third-Party-Tools.

1. Logge Dich ins CapTrader Kunden-Portal ein (oder IBKR Client Portal)
2. Navigiere zu Performance & Berichte → Flex Web Service
3. Falls noch nicht aktiviert: “Flex Web Service aktivieren” klicken
4. Auf der nächsten Seite siehst Du den Button “Token generieren” — aber noch nicht klicken! Zuerst die Query anlegen (Schritt 2).

Menü-Pfad: Performance & Berichte → Flex Web Service

Flex Web Service Übersichts-Seite mit “Token generieren”-Button

2) Activity Flex Query anlegen

Die “Activity Flex Query” ist Depotlogs Haupt-Datenquelle. Sie liefert Trades, Cash-Bewegungen, Positions-Snapshots — alles was Du im Trade-Journal siehst.

1. Navigiere zu Performance & Berichte → Flex Queries → Activity Flex Query
2. Klicke “Erstellen” (oder ”+ Neu”)
3. Name: Depotlog_Activity (oder wie Du willst — Depotlog braucht später nur die Query-ID)

Neue Activity Flex Query erstellen

4. Sections aktivieren. Für jede Section durchläufst Du immer denselben 2-Schritt-Ablauf:

   1. Section per Haken aktivieren (öffnet automatisch einen Konfigurations-Dialog mit einer langen Liste an Feldern wie Account ID, Currency, Starting Cash, Commissions, Dividends, …)
   2. Ganz oben im Dialog die Checkbox “Alle auswählen” anklicken → alle Felder darunter bekommen automatisch ein Häkchen
   3. Dialog schließen / bestätigen

   ⛔ Der häufigste Erst-Setup-Fehler Wenn Du “Alle auswählen” vergisst, wird die Section zwar in die XML aufgenommen, aber die einzelnen Spalten kommen leer an → Depotlog importiert nichts, und die Fehlermeldung ist unauffällig. Bitte wirklich für jede der folgenden Sections durchmachen, nicht nur bei der ersten.

   Diese Sections aktivieren (deutsche Namen im CapTrader-Portal, jeweils mit “Alle auswählen” im Dialog):

   • ✅ Trades
   • ✅ Cash-Bericht (englisch: Cash Report — die Konto-Salden)
   • ✅ Bartransaktionen (englisch: Cash Transactions — Pflicht für Dividenden-Import, Depotlog liest Dividenden-Events ausschließlich aus dieser Section)
   • ✅ Offene Positionen (englisch: Open Positions — für Cost-Basis-Verifikation)
   • ✅ Kapitalmaßnahmen (englisch: Corporate Actions — für Splits und Spin-Offs)
   • ✅ Mutual Fund Dividend Details — für ETF-Ausschüttungen mit Detail-Aufschlüsselung
   • Optional: Change in Position Value — für erweiterte Analytics

   ⚠️ Cash-Bericht ≠ Bartransaktionen Beide klingen ähnlich, liefern aber komplett unterschiedliche Daten: “Cash-Bericht” gibt Dir Konto-Salden (aggregiert), “Bartransaktionen” gibt Dir einzelne Cash-Events (Dividenden, Zinsen, Withholding Tax). Beide sind Pflicht — ohne Bartransaktionen sieht Dein Depotlog-Dividenden-Dashboard leer aus.

Alle Pflicht-Sections mit Häkchen — links u.a. Bartransaktionen und Cash-Bericht, rechts Offene Positionen, Trades, Kapitalmaßnahmen

5. Zustellungskonfiguration:

   • Konten: alle Konten anhaken die Du in Depotlog sehen willst (z.B. Trading + Invest)
   • Format: XML (wichtig — Depotlog kann nur XML lesen)
   • Zeitraum: Letzte 365 Kalendertage (für Import bestehender Historie)

   ℹ️ Maximal 1 Jahr rückwärts IBKR / CapTrader lassen bei der Kontoumsatz-Flex-Query maximal 365 Kalendertage zurück abfragen — mehr geht schlicht nicht. Wenn Du längere Historie brauchst, musst Du sie separat manuell importieren (kommt in einer späteren Depotlog-Version als CSV-Upload). Für den Erstsync sind 365 Tage aber der Standard-Wert.

Konten anhaken, Format XML, Zeitraum 365 Tage

6. Speichern → notiere die Query-ID (5-7-stellige Zahl, z.B. 1234567)

Die Query-ID nach dem Speichern — diese Zahl brauchst Du für Schritt 5

3) (Optional) Trade Confirmation Flex Query anlegen

Depotlog unterstützt zusätzlich eine “Trade Confirmation” Query (TCF) für near-realtime Trade-Import. Der Unterschied:

• Activity Query (AF): Update erst am Ende des Handelstages (End-of-Day)
• Trade Confirmation Query (TCF): Update stündlich direkt nach Order-Ausführung

Wenn Du also am selben Tag Deine frischen Trades in Depotlog sehen willst, richte die TCF ein.

1. Navigiere zu Performance & Berichte → Flex Queries → Trade Confirmation Flex Query
2. Klicke “Erstellen”
3. Name: Depotlog_TradeConfirmations
4. Sections aktivieren:
   • ✅ Trade Confirmations (Standard)
5. Zustellungskonfiguration:
   • Konten: alle wie in Schritt 2
   • Format: XML
   • Zeitraum: Same Day oder Last Business Day
6. Speichern → notiere die TCF-Query-ID (andere 5-7-stellige Zahl)

Trade Confirmation Query — Schritt 1: Neue Query erstellen und benennen

Trade Confirmation Query — Schritt 2: Section “Trade Confirmations” aktivieren (mit “Alle auswählen” im Dialog)

Trade Confirmation Query — Schritt 3: Zustellungskonfiguration (Konten, XML-Format, Zeitraum Same Day / Last Business Day)

💡 Tipp: Diese Query ist optional. Wenn Du nur einmal pro Tag Dein Depot ansehen willst, reicht die Activity Query aus Schritt 2. TCF ist für aktive Trader die täglich mehrfach reinschauen.

4) Token generieren

Jetzt zurück zum Flex Web Service (Schritt 1):

1. Performance & Berichte → Flex Web Service
2. Klicke “Token generieren”
3. Token-Konfiguration:
   • Expiry (Ablaufdatum): so lang wie möglich (typisch 30 Tage bis 1 Jahr) — Depotlog warnt Dich rechtzeitig wenn der Token bald abläuft
   • IP-Restriction: leer lassen (Depotlog läuft auf einem Server mit dynamischer IP)
4. Klick “Generieren” → Token wird einmalig angezeigt
5. Kopiere den Token sofort in ein sicheres Notizfeld — er wird nach dem Fenster-Schließen nicht mehr angezeigt

📸 Screenshot fehlt noch: depotlog-broker-08-token-generieren.png Was das Bild zeigen soll: Token-Konfigurations-Dialog vor dem Bestätigen — mit langem Expiry (30 Tage oder länger), IP-Restriction leer, evtl. Description-Feld ausgefüllt. Der Zustand direkt vor Klick auf “Generieren”.

📸 Screenshot fehlt noch: depotlog-broker-09-token-anzeige.png Was das Bild zeigen soll: Der generierte Token-String der nach “Generieren”-Klick einmalig angezeigt wird (~50-60 Zeichen lange Zeichenkette) + der Hinweis-Text von CapTrader dass der Token nach Schließen nicht mehr abrufbar ist. Aus Sicherheits-Gründen kann der Token in dem Screenshot geschwärzt/verpixelt sein — wichtig ist die Anzeige-Situation, nicht der echte String.

⚠️ Token verloren? Falls Du den Token verlierst, kannst Du keinen “wiederherstellen” — Du musst einen neuen generieren und Depotlog aktualisieren. Also wirklich sofort kopieren.

5) Token + Query-IDs in Depotlog eintragen

⛔ Erinnerung: JETZT bei CapTrader/IBKR ausloggen Bevor Du in Depotlog auf “Synchronisieren” klickst: alle CapTrader/IBKR-Tabs schließen und aus TWS/Gateway ausloggen. Siehe rote Box am Anfang der Anleitung.

1. Logge Dich in Depotlog ein → app.depotlog.com
2. Navigiere zu Broker Sync (im Sidebar-Menü)
3. Wähle Dein Broker-Setup:
   • CapTrader-Card klicken (oder IBKR direkt)

Broker-Sync im Depotlog-Sidebar-Menü

4. Klicke “Neue Credentials hinterlegen” (oder “Konfiguration”)
5. Eingabe:
   • Flex-Token: den gerade generierten Token einfügen
   • Activity Query-ID: die 5-7-stellige Nummer aus Schritt 2
   • Trade Confirmation Query-ID: aus Schritt 3 (leer lassen wenn Du keine TCF eingerichtet hast)
6. Speichern

📸 Screenshot fehlt noch: depotlog-broker-11-broker-sync-modal.png Was das Bild zeigen soll: Das Depotlog-Modal “Neue Credentials hinterlegen” auf der Broker-Sync-Seite, mit den drei Eingabefeldern:

1. Flex-Token (Passwort-Feld, evtl. schon teilweise ausgefüllt / masked)
2. Activity Query-ID (5-7-stellige Nummer)
3. Trade Confirmation Query-ID (optional, für TCF-Nutzer)

Idealerweise mit sichtbarem Speichern-Button und Test-Verbindung-Option.

6) Erste Synchronisation auslösen

1. Nach dem Speichern siehst Du in der Broker-Card einen “Jetzt synchronisieren”-Button
2. Klick drauf → Sync startet
3. Nach 10–30 Sekunden (je nach Trade-Volumen):
   • ✅ Erfolg: grüne Meldung mit “X Trades importiert, Y Positionen aktualisiert”
   • ❌ Fehler: siehe Fehler-Behebung unten

Erfolgreiche erste Synchronisation

Verifikation — was Du prüfen solltest

Nach erfolgreichem Import:

• Positionen (/positions) zeigt Deine offenen Positionen mit Live-Kursen
• Transaktionen (/transactions) zeigt Deine Trades chronologisch (365 Tage rückwärts)
• Rebalancing (/rebalancing) zeigt Deine Asset-Klassen-Verteilung
• Cash-Bestände in Deiner Kontowährung(en) korrekt

Wenn eines dieser Views leer ist trotz Sync-Erfolg → siehe Fehler-Behebung.

Was passiert danach automatisch?

Sobald die Verbindung steht, läuft Depotlog ohne Dein Zutun:

• Activity Query: täglich End-of-Day (~22:00 CET) für vollständigen Portfolio-Snapshot
• Trade Confirmation Query: stündlich Mo–Fr während US-Marktzeit (15:30–22:00 CET) für frische Trades
• Live-Kurse: alle 15 Minuten (Yahoo Finance)
• FX-Rates: täglich (ECB-Referenzkurs)

Du kannst jederzeit “Jetzt synchronisieren” klicken um manuell einen Refresh auszulösen.

💡 Ab jetzt kannst Du parallel bei IBKR eingeloggt sein Die harte “Nicht eingeloggt sein”-Regel gilt nur für den allerersten Sync. Danach läuft der reguläre Auto-Sync auch dann, wenn Du in TWS aktiv bist — solange Du nicht ständig manuell synchronisierst, während gleichzeitig eine TWS-Session offen ist. Falls Du dauerhaft konfliktfrei arbeiten willst: Sub-User anlegen (01 IBKR Sub-User für Flex Web Service).

Fehler-Behebung

”The following accounts were excluded from this statement: U…”

Was das heißt: Du bist parallel in TWS oder Client Portal eingeloggt und IBKR schließt eines Deiner Konten aus der API-Antwort aus (Concurrent-Session-Limit). Das ist der häufigste Fehler beim ersten Setup.

Lösung:

1. Alle CapTrader/IBKR-Tabs schließen, aus TWS/Gateway ausloggen
2. 60 Sekunden warten
3. Sync in Depotlog erneut auslösen

Wenn Du dauerhaft parallel arbeiten willst → Sub-User anlegen (01 IBKR Sub-User für Flex Web Service).

1019 - too many requests

Was das heißt: IBKR hat pro Token ein Rate-Limit von einem Request alle 30 Sekunden. Wenn Du mehrmals hintereinander synct oder mehrere Anwendungen den gleichen Token nutzen, blockt IBKR temporär.

Lösung: 60 Sekunden warten, nochmal versuchen. Depotlog macht automatisch einen “Retry-once-after-30s” — das ist im Server-Verhalten so gebaut.

”Query ID nicht gefunden” oder “Invalid query”

Mögliche Ursachen:

1. Query-ID falsch abgeschrieben → nachprüfen im CapTrader-Portal unter Flex Queries
2. Query wurde von einem anderen User erstellt → sie muss vom selben User stammen der auch den Token generiert hat
3. Query wurde deaktiviert → im Portal “Aktiv”-Status prüfen

”Kein Trade importiert” trotz erfolgter Trades

Mögliche Ursachen:

1. In der Query fehlen die richtigen Konten → alle relevanten Konten in der Query-Konfiguration anhaken (Schritt 2)
2. Zeitraum-Config falsch → “Letzte 365 Kalendertage” stellen (nicht “Same Day”)
3. Trade-Datum liegt außerhalb der Query-Zeitspanne
4. Du warst beim Sync parallel eingeloggt → siehe oben, ausloggen + neu syncen

Sync bricht ab mit HTTP 401 - Invalid token

Was das heißt: Der Token ist abgelaufen oder wurde widerrufen.

Lösung: Neuen Token in CapTrader generieren (Schritt 4) und in Depotlog aktualisieren (Schritt 5).

FAQ

Q: Wie oft läuft der Sync? Activity Query: 1x täglich EoD. Trade Confirmation Query: stündlich Mo–Fr während US-Marktzeit.

Q: Muss mein Computer für den Sync laufen? Nein. Depotlog läuft auf einem Server. Sync passiert automatisch — Du kannst Dein Notebook ausschalten, im Urlaub sein, das Depot ist trotzdem aktuell.

Q: Was ist der Unterschied zwischen Activity Query und Trade Confirmation Query? Activity Query gibt Dir den kompletten Snapshot am Ende des Handelstages. Trade Confirmation Query gibt Dir stündlich frische Trades während des Handelstages. Für Buy-and-Hold reicht Activity Query. Für aktive Trader ist Trade Confirmation Query nice-to-have.

Q: Meine Position ist mit Verlust angezeigt, obwohl der Kurs gestiegen ist — warum? Wahrscheinlich Currency-Mismatch. Prüfe ob die Position-Währung mit Deiner tatsächlichen Konto-Währung übereinstimmt. Depotlog zeigt Preise immer in Position-Währung und konvertiert für Aggregate via ECB.

Q: Wo sehe ich meine Dividenden? Aktuell nicht separat ausgewiesen — kommt als Cash-Bewegung im Cash-Report. Dedizierte Dividend-Tracking-View ist in der Roadmap (Wave 2).

Q: Was passiert wenn ich einen Trade in TWS storniere / korrigiere? Der nächste Sync-Zyklus (spätestens EoD) übernimmt die Korrektur automatisch aus der IBKR-Datenquelle.

Q: Kann ich das Setup mit einem Papertrading-Konto testen? Ja. Die Flex-Query-Mechanik funktioniert für Papertrading identisch. Guter Weg für vorsichtige Tester, das Onboarding einmal risikofrei durchzuspielen.

Weitere Fragen?

• Kontakt: kontakt@depotlog.com
• Weitere Doku: 00 Einleitung

Historie dieser Doku

• 2026-07-21: Rote Warnung ganz oben eingebaut (paralleles Login beim ersten Sync verhindert Import — häufigster Onboarding-Fehler laut Werner-Praxis). Screenshots eingebettet mit Naming-Convention depotlog-broker-XX-*.png in User-Doku/Screenshots/. Papertrading-Hinweis in Voraussetzungen + FAQ. Zielgruppe klarer auf Beta-Tester (Claus + neue User) zugeschnitten.
• 2026-07-15: Erstanlage im Zug des Wave-1-Beta-Onboarding (nach Claus-Feedback zur fehlenden Anleitung).