IBKR Flex Query einrichten

Setting up your IBKR Flex Query

Ein IBKR Flex Query ist die erweiterte Option für Power-User — er enthält ISINs für alle Trades und ermöglicht automatischen API-Abruf. Für die meisten Nutzer reicht der Standard Activity Statement direkt aus dem IBKR-Portal. Falls du einen Flex Query einrichten möchtest, gibt es zwei Wege:

An IBKR Flex Query is the advanced option for power users — it includes ISINs for all trades and enables automatic API refresh. For most users the Standard Activity Statement from the IBKR portal is sufficient. If you'd like to set up a Flex Query, there are two ways:

---

Schritt 1 — Flex Query erstellen (einmalig)

Step 1 — Create the Flex Query (one-time setup)

Dieser Schritt ist für beide Methoden identisch. Du erstellst die Flex Query einmal und speicherst sie.

This step is the same for both methods. You create the Flex Query once and save it.

1. Melde dich im IBKR Client Portal an.
2. Log in to the IBKR Client Portal.
3. Navigiere zu Reports → Flex Queries.
4. Navigate to Reports → Flex Queries.

3. Klicke auf „Create" / „Neue Flex Query erstellen".
4. Click "Create" / "Create New Flex Query".
5. Wähle den Typ Activity Flex Query.
6. Select the type Activity Flex Query.
7. Aktiviere mindestens diese Sektionen:
   • Trades — Kauf- und Verkaufstransaktionen
   • Cash Transactions — Dividenden und Zinsen
   • Open Positions — aktueller Portfoliowert (optional, aber empfohlen)
8. Enable at least these sections:
   • Trades — buy and sell transactions
   • Cash Transactions — dividends and interest
   • Open Positions — current portfolio value (optional but recommended)

6. Speichere die Query unter einem beliebigen Namen, z.B. „KapFrei 2026".
7. Save the query with any name, e.g. "KapFrei 2026".

---

Methode A — Automatischer Abruf (aktuelles Jahr)

Method A — Auto-fetch (current year)

Für den automatischen Abruf benötigst du zwei Dinge: den Flex Token und die Query ID.

For auto-fetch you need two things: your Flex Token and the Query ID.

Zeitraum auf „Jahr-bis-dato" setzen

Set period to "Year to Date"

1. Öffne deine gespeicherte Flex Query über Reports → Flex Queries.
2. Open your saved Flex Query via Reports → Flex Queries.
3. Klicke auf das Bearbeiten-Symbol (Bleistift).
4. Click the edit icon (pencil).
5. Setze Period → Year to Date.
6. Set Period → Year to Date.

Flex Token generieren

Generate Flex Token

1. Navigiere zu Settings → Flex Web Service → Manage Tokens.
2. Navigate to Settings → Flex Web Service → Manage Tokens.
3. Klicke auf „Create Token". Der Token ist ein langer alphanumerischer String — kopiere ihn.
4. Click "Create Token". The token is a long alphanumeric string — copy it.

Query ID ermitteln

Find your Query ID

1. Gehe zu Reports → Flex Queries und öffne deine Query.
2. Go to Reports → Flex Queries and open your query.
3. Die Query ID ist die 6-stellige Zahl in der Browser-URL (z.B. ...queryId=123456...).
4. The Query ID is the 6-digit number in the browser URL (e.g. ...queryId=123456...).

---

Methode B — CSV manuell exportieren (Vorjahre)

Method B — Manual CSV export (prior years)

Für Vorjahre oder wenn der automatische Abruf gesperrt ist (IBKR Cooldown): Report direkt in IBKR ausführen, CSV herunterladen und hochladen.

For prior years or when auto-fetch is throttled (IBKR cooldown): run the report directly in IBKR, download the CSV, and upload it.

Empfehlung zur Archivierung: Speichere den CSV-Export auch lokal (z.B. in der Cloud) — du benötigst ihn möglicherweise später für steuerliche Prüfzwecke.

Archiving tip: Keep the CSV export locally too (e.g. in cloud storage) — you may need it later for tax audit purposes.

1. Navigiere zu Reports → Flex Queries.
2. Navigate to Reports → Flex Queries.
3. Wähle deine gespeicherte Query aus.
4. Select your saved query.
5. Klicke auf „Run" (Ausführen-Symbol).
6. Click "Run" (the run/play icon).
7. Wähle den Zeitraum: Custom Date Range → 01.01.{Jahr} bis 31.12.{Jahr}.
8. Choose period: Custom Date Range → 01/01/{year} to 12/31/{year}.

5. Wähle als Format CSV.
6. Select format CSV.
7. Klicke „Run" — der Download startet automatisch.
8. Click "Run" — the download starts automatically.

Lade die heruntergeladene .csv-Datei dann in KapFrei im Tab „CSV-Datei hochladen" hoch.

Then upload the downloaded .csv file in KapFrei on the "Upload CSV file" tab.

Mehrere verknüpfte Konten (z.B. nach IBKR-Kontomigration)? → FAQ: Multi-Account-Setup

Multiple linked accounts (e.g. after IBKR account migration)? → FAQ: Multi-account setup

---

Häufige Fragen

Frequently asked questions

Warum funktioniert der automatische Abruf gerade nicht?

Why is auto-fetch not working right now?

IBKR begrenzt die Häufigkeit von API-Abrufen. Nach mehreren Abrufen in kurzer Zeit tritt eine Sperre ein (IBKR Error 1001). Diese dauert typischerweise einige Stunden bis zu einem Tag. Lösung: CSV manuell exportieren (Methode B).

IBKR limits the frequency of API fetches. After several fetches in a short period, a cooldown kicks in (IBKR Error 1001). This typically lasts a few hours to a day. Solution: export CSV manually (Method B).

Welche Flex Query Sektionen sind Pflicht?

Which Flex Query sections are required?

Trades und Cash Transactions sind Pflicht. Open Positions ist optional — ohne werden FIRE-Dashboard-Werte über Yahoo Finance geschätzt, was bei europäischen Aktien weniger zuverlässig ist.

Trades and Cash Transactions are required. Open Positions is optional — without it, FIRE dashboard values are estimated via Yahoo Finance, which is less reliable for European stocks.

Kann ich die Mobile App verwenden?

Can I use the mobile app?

Für den einmaligen Setup (Query erstellen, Zeitraum auf Jahr-bis-dato setzen) empfehlen wir das Web Portal. Die Mobile App zeigt nicht alle Zeitraum-Optionen. Für das manuelle Ausführen einer bestehenden Query ist die App ausreichend.

For the one-time setup (creating the query, setting period to Year to Date) we recommend the Web Portal. The mobile app does not show all period options. For running an existing query manually, the app is fine.