IBKR Flex Query einrichten: Flex Web Service, Activity- und Trade-Confirmation-Abfrage

Der Flex Web Service ist eine Schnittstelle von Interactive Brokers, über die eine Anwendung vordefinierte Berichte (Flex Queries) per Token abruft. Anders als die TWS-API braucht sie keine laufende Trader Workstation: Die Abfrage geht direkt an die IBKR-Server und liefert die Ausführungen, Kontobewegungen und Positionen als XML. Bei Introducing Brokern wie CapTrader, LYNX oder Estably steht der Flex Web Service in der Regel genauso zur Verfügung, weil die Konten auf derselben Plattform geführt werden.

Für ein Trading-Journal braucht es zwei Abfragen. Die Kontoumsatz-Flex-Query (Activity Flex Query) liefert die Historie bis 365 Tage zurück und wird von IBKR über Nacht aufbereitet. Die Handelsbestätigungs-Flex-Query (Trade Confirmation Flex Query) liefert die Ausführungen des laufenden Tages, meist fünf bis zehn Minuten nach der Ausführung. Beide Abfragen werden einmal im Client Portal angelegt, danach braucht die Software nur noch den Prüfcode (Token) und die beiden Query-IDs.

Schritt für Schritt

1. 1

   Flex-Web-Service aktivieren und Prüfcode erzeugen

   Im IBKR Client Portal (Kontoverwaltung) anmelden und zu Performance & Berichte (Performance & Reports), dann Flex-Queries wechseln.

   

   • Wer mehrere Konten hat, wählt zuerst unter Konten auswählen alle Konten aus und klickt Weiter, sonst erscheint der Konfigurationsbereich nicht.
     
   • Rechts den Bereich Flex-Web-Service-Konfiguration suchen und das Zahnrad Konfigurieren anklicken.
     
   • Flex-Web-Service-Status aktivieren und mit Save speichern. IBKR zeigt danach unter Aktiver Prüfcode das Token an: eine lange Zahlenfolge, die du in die Software einträgst.
     
   • Der Aktivierungszeitraum des Prüfcodes wird daneben angezeigt, standardmässig ein Jahr. Nach Ablauf erzeugst du mit Neuen Prüfcode generieren an derselben Stelle ein neues Token.
2. 2

   Kontoumsatz-Flex-Query anlegen (Historie bis 365 Tage)

   Bei Kontoumsatz-Flex-Query (Activity Flex Query) auf das Plus Erstellen klicken und einen Namen vergeben, etwa "Journal Kontoumsatz". Dann unter Abschnitte diejenigen auswählen, die die Software braucht: bei jedem Abschnitt anklicken, Alle auswählen aktivieren und speichern.

   

   • Trades: im Dialog prüfen, dass Ausführung (Executions) gewählt ist, dann Alle auswählen.
     
   • Je nach Funktionsumfang der Software müssen neben Trades weitere Abschnitte aktiviert werden, etwa Kontoinformationen, Bartransaktionen (Cash Transactions), Kapitalmassnahmen (Corporate Actions), Transfers oder Optionsausübungen. Welche genau, steht in der Anleitung der jeweiligen Software.
     
3. 3

   Format und Zeitraum der Kontoumsatz-Query

   Im unteren Teil der Abfrage die Ausgabe festlegen. Diese Einstellungen können je nach Software variieren.

   • Zustellungskonfiguration: Modelle Optional, Format XML, Zeitraum Letzte 365 Kalendertage. XML ist das Format, das der Flex-Web-Service ausliefert und das praktisch jede Software einliest. 365 Kalendertage sind der maximale Zeitraum einer Kontoumsatz-Query.
     
   • Allgemeine Konfiguration: Datums- und Zeitformat, Trennzeichen, Gewinn-und-Verlust-Methode und die Ja/Nein-Optionen darunter sind Konventionen der jeweiligen Software. Welche Werte sie erwartet, steht in ihrer Anleitung.
   • Mit Erstellen anlegen und mit OK bestätigen. Über das Stift-Symbol neben der Abfrage die Query-ID kopieren, eine siebenstellige Zahl.
4. 4

   Handelsbestätigungs-Flex-Query anlegen (Trades des Tages)

   Bei Handelsbestätigungs-Flex-Query (Trade Confirmation Flex Query) auf das Plus klicken, Namen vergeben, etwa "Journal Heute", und Handelsbestätigung mit Alle auswählen aktivieren. Der Zeitraum ist bei dieser Abfrage fest auf Heute gesetzt.

   

   • Zustellungskonfiguration: Modelle Optional, Format XML. Die Allgemeine Konfiguration mit denselben Werten wie bei der Kontoumsatz-Query, also so, wie es die Software verlangt.
     
   • Weiter, Erstellen, OK. Die Query-ID wie bei der Kontoumsatz-Query über das Stift-Symbol kopieren.
5. 5

   Prüfcode und Query-IDs in der Software eintragen

   Die Software braucht drei Werte: den Prüfcode (Token) aus Schritt 1 sowie die Query-IDs der Kontoumsatz- und der Handelsbestätigungs-Query. Wie oft und wann die Abfragen abgerufen werden, legt die jeweilige Software fest. Die Grenzen setzt IBKR: Die Kontoumsatz-Query liefert neue Daten erst nach der Nachtverarbeitung, die Handelsbestätigungs-Query innerhalb weniger Minuten nach der Ausführung.

Gut zu wissen

• Kontoumsatz-Daten stehen erst nach der Nachtverarbeitung von IBKR bereit, etwa vier bis sechs Stunden nach Börsenschluss. Für Trades des laufenden Tages ist die Handelsbestätigungs-Query zuständig.
• Die Kontoumsatz-Query reicht maximal 365 Kalendertage zurück. Ältere Daten können über den CSV-Export des Kontoauszugs heruntergeladen werden.
• Der Flex-Web-Service funktioniert nur mit Live-Konten. Paper-Trading-Konten sind auf die TWS-API oder den CSV-Import angewiesen.
• Flex-Zeitstempel sind in US-Ostküstenzeit. Eine Software muss sie umrechnen, sonst rutschen Abendtrades auf den falschen Tag.
• Jedes Leg einer Combo-Order bekommt in Flex eine eigene Ordernummer. Software, die Legs über die Ordernummer gruppiert, zerlegt jeden Spread in Einzeltrades.

Häufige Fragen