2.1
🚀 2 · Pierwsze kroki

🔶 Konfiguracja Interactive Brokers

Flex Query i automatyczna synchronizacja

W tym rozdziale

1 Przegląd 2 Czym jest Flex Query? 3 Krok 1: Utwórz Flex Query w IBKR 4 Krok 2: Skonfiguruj Flex Query 5 Krok 3: Wybierz sekcje raportu 6 Krok 4: Zapisz zapytanie 7 Krok 5: Wygeneruj token Flex Query 8 Krok 6: Eksport XML dla wszystkich lat 9 Krok 7: Import XML historii 10 Krok 8: Konfiguracja w Singularity Trader 11 Automatyczna synchronizacja 12 Automatyczne ponawianie przy tymczasowych błędach 13 Alternatywa: Ręczny import XML 14 Importowane dane z IBKR 15 📥 Dane z TradingLogbook? Przenieś swoje tagi. 16 Rozwiązywanie problemów 17 Ładowanie brakujących historycznych transakcji (⚠️-odznaka przy pozycjach)

1. Przegląd

Interactive Brokers (IBKR) oferuje najobszerniejszą integrację.

✅ Proces:
1. Utwórz Flex Query
2. Pobierz i zaimportuj Flex Query jako XML dla każdego roku
3. Otrzymuj aktualizacje przez Flex Sync
⚠️ Ważne:
Flex Sync pobiera tylko aktualizacje z ostatnich dni. Import XML buduje kompletną historię. Bez kompletnej historii system nie może prawidłowo ocenić transakcji (np. strategii opcyjnych, kampanii, zysków forex).

2. Czym jest Flex Query?

Flex Query to konfigurowalny raport z Interactive Brokers. Raz definiujesz, jakie dane chcesz wyeksportować, potem możesz ten raport pobrać w dowolnym momencie - ręcznie lub automatycznie.

Zalety:
• Wszystkie transakcje, dywidendy, pozycje w jednym raporcie
• Możliwość automatycznej synchronizacji
• Dane z ostatnich 365 dni dostępne
• Brak konieczności ręcznego wprowadzania danych

Przewodnik krok po kroku

1

Krok 1: Utwórz Flex Query w IBKR

1. Zaloguj się do IBKR:
Przejdź na interactivebrokers.com i zaloguj się na swoje konto.

2. Otwórz Flex Queries:
Nawiguj do: Performance & Reports → Flex Queries

3. Utwórz nowe Activity Flex Query:
Kliknij symbol ➕ obok "Activity Flex Query Viewer" → "Create"
2

Krok 2: Skonfiguruj Flex Query

Nazwa zapytania: np. "SingularityTrader"

Konfiguracja dostarczania:
• Okres: Ostatnie 365 dni kalendarzowych
• Format daty: yyyyMMdd
• Format czasu: HHMMSS
• Uwzględnij rekordy nagłówka i stopki: Nie

Konfiguracja ogólna:
• Format: XML
• Uwzględnij anulowane transakcje: Nie
3

Krok 3: Wybierz sekcje raportu

Włącz wszystkie następujące sekcje w Flex Query:

• Accrued Interest
• Cash Transactions
• CFD Charges
• Cash Report
• Inbound/Outbound Trade Transfers
• Forex P&L Details
• Financial Instrument Information
• Corporate Actions
• Account Information
• Net Asset Value (NAV) in Base Currency
• Open Positions
• Open Dividend Accruals
• Option Exercises, Assignments, and Expirations
• Previous Period Positions
• Statement of Funds
• Trades
• Transaction Fees
• Transfers
• Change in Dividend Accruals

⚠️ Ważne: Dla każdej sekcji wybierz wszystkie dostępne pola ("Select All").
4

Krok 4: Zapisz zapytanie

Kliknij "Continue", a następnie "Create".

Po utworzeniu zobaczysz swoje zapytanie na liście. Zanotuj Query ID - za chwilę będzie ci potrzebne.
5

Krok 5: Wygeneruj token Flex Query

Do automatycznego pobierania potrzebujesz tokenu:

1. Otwórz sekcję tokenów:
W obszarze Flex Queries: Kliknij symbol ⚙️ po prawej stronie (Zarządzaj tokenami)

2. Utwórz nowy token:
Kliknij "Generate New Token"

3. Skopiuj token:
Token jest wyświetlany tylko raz! Skopiuj go natychmiast i przechowaj w bezpiecznym miejscu.

⚠️ Ważne: Token jest ważny przez 1 rok. Po wygaśnięciu musisz wygenerować nowy.
6

Krok 6: Eksport XML dla wszystkich lat

Wyeksportuj Flex Query jako XML dla każdego roku twojej historii tradingowej:

1. Otwórz Flex Query:
W IBKR: Performance & Reports → Flex Queries

2. Dostosuj zakres dat:
Edytuj zapytanie i ustaw zakres dat na jeden rok kalendarzowy (np. 01/01/2023 - 31/12/2023)

3. Uruchom zapytanie:
Kliknij "Run" i pobierz plik XML

4. Powtórz dla każdego roku:
Powtórz kroki 2-3 dla wszystkich lat, w których handlowałeś w IBKR (np. 2021, 2022, 2023, 2024).
7

Krok 7: Import XML historii

Zaimportuj wszystkie pobrane pliki XML do Singularity Trader:

1. Otwórz sekcję importu:
Przejdź do Konta → Twoje konto IBKR → Konfiguracja → "Upload XML"

2. Najstarszy rok najpierw:
Zacznij od najstarszego pliku XML (np. 2021) i pracuj chronologicznie do przodu

3. Zaimportuj wszystkie lata:
Importuj wszystkie pliki XML sekwencyjnie aż do bieżącego roku

⚠️ Ważne: Ten krok jest niezbędny! Bez kompletnej historii nie można prawidłowo obliczyć strategii opcyjnych, kampanii tradingowych i zysków forex.
8

Krok 8: Konfiguracja w Singularity Trader

1. Otwórz konfigurację konta:
Przejdź do Konta → Twoje konto IBKR → Konfiguracja

2. Wprowadź dane Flex Query:
• Flex Query ID: Numer zapytania z IBKR
• Flex Token: Wygenerowany token

3. Zapisz i przetestuj:
Kliknij "Zapisz", a następnie "Synchronizuj teraz", aby przetestować.
✨

Automatyczna synchronizacja

Po pomyślnej konfiguracji twoje transakcje są automatycznie synchronizowane codziennie. Nie musisz nic więcej robić!

Co się dzieje podczas synchronizacji:
• Nowe transakcje są importowane
• Pozycje są aktualizowane
• Dywidendy są rejestrowane
• Strategie opcyjne są rozpoznawane
• Zyski forex są obliczane (FIFO)

Zawsze możesz ręcznie zsynchronizować, jeśli chcesz najnowsze dane natychmiast.

12. Automatyczne ponawianie przy tymczasowych błędach

Pobrania Flex IBKR mogą czasami zakończyć się niepowodzeniem z różnych przyczyn (np. chwilowy błąd serwera IBKR, timeout sieci, zapytanie w trakcie przetwarzania). Singularity Trader posiada automatyczną kolejkę powtórzeń:

• Jeśli synchronizacja się nie powiedzie, zostanie automatycznie ponowiona do 3 razy (z wykładniczymi odstępami).
• Dopiero gdy wszystkie próby zawiodą, w dzienniku systemowym pojawi się wpis CRITICAL i powiadomienie.
• Tymczasowe problemy zazwyczaj rozwiązują się same, bez konieczności interwencji.

Aktualny status synchronizacji możesz sprawdzić w sekcji Konta — zielony = ostatnia synchronizacja udana, żółty = trwa ponowienie, czerwony = nieudane po 3 próbach.

13. Alternatywa: Ręczny import XML

Jeśli nie chcesz automatycznej synchronizacji, możesz ręcznie wyeksportować Flex Query:

1. W IBKR: Flex Queries → "Run" obok swojego zapytania
2. Pobierz: Zapisz plik XML
3. Prześlij: W Singularity Trader → Konta → Konfiguracja → "Prześlij XML"

Ta metoda jest też niezbędna dla starszych danych (> 365 dni), ponieważ Flex Sync sięga tylko 1 rok wstecz.

14. Importowane dane z IBKR

W pełni obsługiwane:
• Transakcje akcjami (kupno/sprzedaż)
• Transakcje opcjami z Grekami
• Kontrakty futures i Forex
• Dywidendy (brutto, netto, podatek u źródła)
• Odsetki (kredytowe/debetowe)
• Wykonania i cesje opcji
• Splity akcji i fuzje
• Statement of Funds dla walutowego FIFO

Automatycznie rozpoznawane:
• Strategie opcyjne (Spreads, Iron Condors itp.)
• Covered Calls / Cash-Secured Puts
• Kampanie tradingowe
• Zyski walutowe zgodnie z § 23 EStG

15. 📥 Dane z TradingLogbook? Przenieś swoje tagi.

📥 Przychodzisz z TradingLogbook?

Twoje strategie możesz przenieść jako tagi na już zaimportowane transakcje — wystarczy Symbol + data otwarcia. Gotowe w 3 minuty.

Do migracji w 3 krokach

⚠️ Rozwiązywanie problemów

„Token wygasł":
Wygeneruj nowy token w IBKR i wprowadź go w konfiguracji.

„Nie znaleziono zapytania":
Sprawdź, czy Query ID jest poprawne i czy zapytanie jest aktywne.

„Brak danych":
Upewnij się, że wszystkie wymagane sekcje są aktywne w zapytaniu.

„Błąd importu":
Sprawdź dziennik importu w celu uzyskania szczegółów. Częsta przyczyna: brakujące pola w zapytaniu.

⚠️ Ładowanie brakujących historycznych transakcji (⚠️-odznaka przy pozycjach)

Problem:
Na pulpicie nawigacyjnym lub na listach pozycji przy pozycji widoczny jest symbol ⚠️ obok nazwy konta. Podpowiedź pokazuje „Brakujące dane transakcji — Dla tej pozycji nie zaimportowano żadnych transakcji. W rezultacie strategia nie może być automatycznie rozpoznana."

Przyczyna:
Sama pozycja jest znana ze snapshotu portfela IBKR, ale transakcje otwarcia leżą przed najwcześniejszym dotychczas zaimportowanym dniem handlowym. Jest to typowe dla LEAPS (długoterminowe opcje), które zostały otwarte miesiące lub lata przed pierwszą synchronizacją Flex.

✅ Rozwiązanie:
W istniejącym Flex Query jednorazowo uruchom eksport ad-hoc z historycznym zakresem dat, pobierz jako XML i prześlij przez import XML. Nie trzeba tworzyć nowego Flex Query!
Krok po kroku:
1. Uruchom historyczny eksport w IBKR
• Znajdź istniejący Flex Query → kliknij Run
• Ustaw Period na Custom Date Range
• Od: tak daleko wstecz jak potrzeba (np. 01.01.2024)
• Do: dzień przed najwcześniejszą zaimportowaną transakcją
• Format: XML → potwierdź Run

2. Pobierz plik XML i zapisz lokalnie

3. Prześlij do Singularity Trader
• Konta → Konto IBKR → „Konfiguruj IBKR" → Import XML

4. Co dzieje się podczas importu
• Importowane są tylko nowe transakcje (bez duplikatów)
• Strategie, kampanie i cykle transakcji są przeliczane od nowa

5. Sprawdź wynik
• Odśwież pulpit — odznaka ⚠️ powinna zniknąć

Jeśli ⚠️ nadal widoczna: Transakcje otwarcia leżą jeszcze dalej w przeszłości → uruchom kolejny eksport z wcześniejszą datą startową.
Jak daleko jesteś z tym rozdziałem?
📖 Otwarte 📚 W trakcie ✅ Ukończone
🎓 Rozpocznij quiz 🔒 Zaloguj się zum E-Learning → 🚶 Kontynuuj czytanie 2.2 · Konfiguracja Trade Republic ▶
← Poprzedni rozdział 2. Pierwsze kroki 📋 Spis treści Następny rozdział 2.2. Konfiguracja Trade Republic →