2.1
🚀 2 · Začínáme

🔶 Nastavení Interactive Brokers

Flex Query a automatická synchronizace

V této kapitole

1 Přehled 2 Co je Flex Query? 3 Krok 1: Vytvoření Flex Query v IBKR 4 Krok 2: Konfigurace Flex Query 5 Krok 3: Výběr sekcí výkazu 6 Krok 4: Uložení dotazu 7 Krok 5: Generování Flex Query tokenu 8 Krok 6: XML export pro všechny roky 9 Krok 7: XML import historie 10 Krok 8: Nastavení v sTraderZ.com 11 Automatická synchronizace 12 Automatické opakování při dočasných chybách 13 Alternativa: Ruční import XML 14 Importovaná data z IBKR 15 📥 Data z TradingLogbook? Přenes si tagy. 16 Řešení problémů 17 Doplnění chybějících historických obchodů (⚠️-odznak u pozic) 18 ✅ Kontrola: jak vypadá hotový dotaz

1. Přehled

Interactive Brokers (IBKR) nabízí nejrozsáhlejší integraci.

✅ Postup:
1. Vytvoření Flex Query
2. Stažení Flex Query jako XML pro každý rok a import
3. Stahování aktualizací přes Flex Sync
⚠️ Důležité:
Flex Sync stahuje pouze aktualizace za poslední dny. XML import buduje kompletní historii. Bez historie nemůže systém správně vyhodnotit obchody (např. opční strategie, kampaně, měnové zisky).

2. Co je Flex Query?

Flex Query je konfigurovatelný výkaz u Interactive Brokers. Jednou definujete, jaká data chcete exportovat, a tento výkaz pak lze kdykoli získat – ručně nebo automaticky.

Výhody:
• Všechny obchody, dividendy, pozice v jednom výkazu
• Možnost automatické synchronizace
• Data za posledních 365 dní
• Není potřeba ruční zadávání dat

Průvodce krok za krokem

1

Krok 1: Vytvoření Flex Query v IBKR

1. Přihlaste se do IBKR:
Přejděte na interactivebrokers.com a přihlaste se ke svému účtu.

2. Otevřete Flex Queries:
Přejděte na: Performance & Reports → Flex Queries

3. Zvolte správný typ dotazu:
Na stránce Flex Queries jsou pod sebou uvedeny dva typy dotazů. Správný je pouze ten první:
✅ Activity Flex Query
Toto je ten správný. Klikněte na ➕ vpravo nahoře v tomto panelu → „Create".
❌ Trade Confirmation Flex Query
Tento nepoužívejte! Obsahuje pouze potvrzení obchodů. sTraderZ.com z něj nedokáže načíst žádná data — import by dopadl zcela prázdný.
Dokud jste ještě žádný dotaz nevytvořili, zobrazuje panel Activity Flex Query jen poznámku, že nemáte žádné šablony. Tlačítko ➕ tam přesto je — v pravém horním rohu tohoto panelu.

ℹ️ Tlačítko „Configure with AI" nepotřebujete — stačí postupovat podle kroků 2 a 3 níže, obsahují všechna nastavení.
2

Krok 2: Konfigurace Flex Query

Název dotazu: libovolný, např. „SingularityTrader".

Poté nastavte Delivery Configuration a General Configuration přesně takto:
0 z 11 nastavení hotovo
3

Krok 3: Výběr sekcí výkazu

Ve Flex Query aktivujte všechny následující sekce. Seznam slouží k odškrtávání — váš postup zůstane uložený, i když stránku znovu načtete.

Názvy sekcí jsou uvedeny anglicky. Pokud máte portál IBKR nastavený na jiný jazyk, budou tam názvy přeložené.
0 z 20 sekcí aktivováno
⚠️ Pole vs. volby typu — zásadní rozdíl

Pole (číslovaný seznam uvnitř každé sekce): vždy použijte „Select All" — čím více, tím lépe. Chybějící pole jsou nejčastější příčinou chyb při importu.

Volby typu (řádek „Options:" v horní části sekce): zde platí opak — zvolte jen jednu úroveň detailu, přesně tu uvedenou výše. Každá další úroveň („Summary", „Orders", „Symbol Summary", „Lots") popisuje tutéž událost podruhé v dalším řádku. sTraderZ.com úroveň detailu nevyhodnocuje, zpracuje každý řádek — více úrovní proto může vést k dvojitě započítaným obchodům, poplatkům a pozicím. Výjimka: „Closed Lots" a „Wash Sales" v sekci Trades nejsou jen nadbytečné, musí být vypnuté.
4

Krok 4: Uložení dotazu

Klikněte na „Continue" a poté „Create".

Po vytvoření uvidíte svůj dotaz v seznamu. Poznamenejte si Query ID – brzy ho budete potřebovat.
5

Krok 5: Generování Flex Query tokenu

Pro automatické stahování potřebujete přístupový klíč. IBKR mu říká token — v sTraderZ.com jej později zadáte jako Flex Token.

1. Otevřete Flex Web Service:
Na stránce Flex Queries sjeďte úplně dolů k bloku „Flex Web Service Configuration" a klikněte na „Configure" (⚙️).

2. Aktivujte službu:
Na stránce „Configure Flex Web Service" musí být Flex Web Service status nastaven na enabled. Pokud je služba vypnutá, sTraderZ.com dotaz nestáhne — IBKR požadavek odmítne.

3. Vygenerujte token:
V sekci „Generate New Token":
0 z 3 nastavení hotovo
⚠️ Token se zobrazí pouze jednou
Ihned si jej zkopírujte a bezpečně uložte. Pokud jej ztratíte, musíte vygenerovat nový — a tím se starý token okamžitě zneplatní. Každá synchronizace, která ještě používá starý token, od té chvíle selže.

Token platí 1 rok. Po vypršení platnosti vygenerujte nový a uložte jej v konfiguraci účtu.
6

Krok 6: XML export pro všechny roky

Exportujte Flex Query jako XML pro každý rok vaší obchodní historie:

1. Spuštění Flex Query:
V IBKR: Performance & Reports → Flex Queries

2. Úprava časového období:
Upravte dotaz a nastavte období na jeden kalendářní rok (např. 01.01.2023 – 31.12.2023)

3. Spuštění dotazu:
Klikněte na „Run" a stáhněte XML soubor

4. Opakujte pro každý rok:
Opakujte kroky 2–3 pro všechny roky, kdy jste u IBKR obchodovali (např. 2021, 2022, 2023, 2024).
7

Krok 7: XML import historie

Importujte všechny stažené XML soubory do sTraderZ.com:

1. Otevření sekce importu:
Přejděte na Účty → Váš IBKR účet → Konfigurace → „Nahrát XML"

2. Nejdříve nejstarší rok:
Začněte nejstarším XML souborem (např. 2021) a postupujte chronologicky vpřed

3. Import všech let:
Importujte postupně všechny XML soubory až do aktuálního roku

⚠️ Důležité: Tento krok je nezbytný! Bez kompletní historie nelze správně vypočítat opční strategie, obchodní kampaně a měnové zisky.
8

Krok 8: Nastavení v sTraderZ.com

1. Otevření konfigurace účtu:
Přejděte na Účty → Váš IBKR účet → Konfigurace

2. Zadání dat Flex Query:
• Flex Query ID: sedmimístné ID dotazu z IBKR (zobrazuje se v přehledu dotazů, např. 1570627)
• Flex Token: token, který jste vygenerovali v kroku 5

3. Uložení a testování:
Klikněte na „Uložit" a poté „Synchronizovat nyní" pro otestování.
✨

Automatická synchronizace

Po úspěšném nastavení se vaše obchody automaticky synchronizují každý den. Nemusíte dělat nic dalšího!

Co se děje při synchronizaci:
• Importují se nové obchody
• Aktualizují se pozice
• Zaznamenávají se dividendy
• Rozpoznávají se opční strategie
• Vypočítávají se měnové zisky (FIFO)

Ruční synchronizaci lze spustit kdykoli, chcete-li mít nejnovější data okamžitě.

12. Automatické opakování při dočasných chybách

Načítání Flex v IBKR může z různých důvodů jednorázově selhat (např. krátkodobá chyba serveru IBKR, timeout sítě, dotaz právě zpracováván). Singularity Trader má pro tyto případy automatickou frontu opakování:

• Pokud se synchronizace nezdaří, bude automaticky opakována až 3× (s exponenciálními odstupy).
• Teprve když selžou všechny pokusy, zobrazí se v systémovém logu záznam CRITICAL a oznámení.
• Dočasné problémy se většinou vyřeší samy, aniž by bylo nutné zasáhnout.

Aktuální stav synchronizace vidíš v sekci Účty — zelená = poslední synchronizace úspěšná, žlutá = probíhá opakování, červená = po 3 pokusech selhalo.

13. Alternativa: Ruční import XML

Pokud nechceš automatickou synchronizaci, můžeš Flex Query ručně exportovat:

1. V IBKR: Flex Queries → „Run" vedle svého dotazu
2. Stažení: Uložit soubor XML
3. Nahrání: V Singularity Trader → Účty → Konfigurace → „Nahrát XML"

Tato metoda je nutná také pro starší data (> 365 dní), protože Flex Sync sahá pouze 1 rok zpět.

14. Importovaná data z IBKR

Plně podporováno:
• Akciové obchody (nákup/prodej)
• Opční obchody včetně Greeks
• Futures a Forex
• Dividendy (hrubé, čisté, srážková daň)
• Úroky (připsané/odepsané)
• Uplatnění a přidělení opcí
• Akciové splity a fúze
• Statement of Funds pro měnové FIFO

Automaticky rozpoznáno:
• Opční strategie (Spreads, Iron Condors atd.)
• Covered Calls / Cash-Secured Puts
• Obchodní kampaně
• Měnové zisky dle § 23 EStG

15. 📥 Data z TradingLogbook? Přenes si tagy.

📥 Přicházíš z TradingLogbook?

Své strategie můžeš přenést jako tagy na již importované obchody — stačí Symbol + datum otevření. Hotovo za 3 minuty.

K přesunu ve 3 krocích

⚠️ Řešení problémů

„Token vypršel":
Vygeneruj nový token v IBKR a zadej ho do konfigurace.

„Dotaz nenalezen":
Ověř, že Query ID je správné a dotaz je aktivní.

„Žádná data":
Ujisti se, že jsou v dotazu aktivovány všechny požadované sekce.

„Chyba importu":
Zkontroluj log importu pro podrobnosti. Časté: chybějící pole v dotazu.

⚠️ Doplnění chybějících historických obchodů (⚠️-odznak u pozic)

Problém:
Na přehledu nebo v seznamech pozic se u pozice zobrazuje symbol ⚠️ vedle názvu účtu. Tooltip ukazuje „Chybějící data obchodů — Pro tuto pozici nebyly importovány žádné transakce. Proto nemůže být strategie automaticky rozpoznána."

Příčina:
Samotná pozice je známa ze snímku portfolia IBKR, ale otevírací obchody leží před nejstarším dosud importovaným obchodním dnem. To je typické pro LEAPS (dlouhodobé opce), které byly otevřeny měsíce nebo roky před prvním Flex Syncem.

✅ Řešení:
V existujícím Flex Query jednorázově spusť ad-hoc export s historickým časovým rozsahem, stáhni jako XML a nahraj přes import XML. Není nutné zakládat nový Flex Query!
Krok za krokem:
1. Spusť historický export v IBKR
• Najdi existující Flex Query → klikni Run
• Nastav Period na Custom Date Range
• Od: tak daleko zpět, jak je potřeba (např. 1. 1. 2024)
• Do: den před nejstarším již importovaným obchodem
• Formát: XML → potvrď Run

2. Stáhni soubor XML a ulož lokálně

3. Nahraj do Singularity Trader
• Účty → Účet IBKR → „Konfigurovat IBKR" → Import XML

4. Co se děje při importu
• Importují se pouze nové obchody (bez duplikátů)
• Strategie, kampaně a obchodní cykly jsou přepočítány

5. Zkontroluj výsledek
• Obnov přehled — odznak ⚠️ by měl zmizet

Pokud ⚠️ zůstává: Otevírací obchody leží ještě dále v minulosti → spusť další export s dřívějším počátečním datem.

18. ✅ Kontrola: jak vypadá hotový dotaz

Po uložení vám IBKR zobrazí souhrnnou stránku („Review your Activity Flex Query"). Porovnejte ji s touto referencí — přesně tak má váš dotaz vypadat, když je vše správně.
SekceVolby typu (řádek „Options:")
Interest Accruals—
Cash TransactionsVšechny podtypy (Dividends, Payment In Lieu Of Dividends, Withholding Tax, Deposits & Withdrawals, Broker/Bond Interest, Other Fees, Other Income …) + Detail
CFD Charges—
Cash Report—
Incoming/Outgoing Trade TransfersTrade Transfers
Forex P/L DetailsTransaction
Grant Activity—
Financial Instrument Information—
Statement of FundsBase Currency Summary, Currency Breakout, Include Starting and Ending Balances
Corporate ActionsDetail
Account Information—
Net Asset Value (NAV) in Base—
Open PositionsSummary (žádné „Lots")
Open Dividend Accruals—
Option Exercises, Assignments and Expirations— (sekce, na kterou se zapomíná nejčastěji!)
Prior Period Positions—
Tradespouze Execution — žádné „Closed Lots", žádné „Wash Sales", žádné „Orders"/„Asset Class"/„Symbol Summary"
Transaction Feespouze Execution (nikoli navíc „Summary")
TransfersTransfer (žádné „Lots")
Change in Dividend AccrualsDetail (nikoli navíc „Summary")

Delivery Configuration a General Configuration:

NastaveníHodnota
AccountsID vašeho účtu (např. U1234567)
FormatXML
PeriodLast 30 Calendar Days
Profit and LossDefault
Include Offsetting Trade/Cancel Pairs?No
Include Currency Rates?No
Include Audit Trail Fields?No
Display Account Alias in Place of Account ID?No
Breakout by Day?No
Date FormatyyyyMMdd
Time FormatHHmmss
Date/Time Separator; (semi-colon)
💡 Poznamenejte si Query ID
Ve stejném přehledu je nahoře uvedeno Query ID (sedmimístné číslo, např. 1570627). Budete jej potřebovat společně s tokenem v kroku 8.
← Předchozí kapitola 2. Začínáme 📋 Obsah Další kapitola 2.2. Nastavení Trade Republic →