Tradewaysdocs
Automatyczny import

Interactive Brokers

Połącz Interactive Brokers jednorazowo za pomocą tokenu Flex Web Service i dwóch Flex Query. Tradeways cyklicznie importuje nowe realizacje akcji, ETF-ów i Forex.

Interactive Brokers

Połącz Interactive Brokers jednorazowo, a Tradeways będzie importować Twoje realizacje automatycznie. Niczego nie instalujesz, a komputer nie musi być włączony: Tradeways według harmonogramu pobiera z Interactive Brokers raporty Flex, które skonfigurujesz.

Połączenie jest tylko do odczytu. Token Flex Web Service może pobierać wyłącznie skonfigurowane przez Ciebie raporty Flex. Nie może składać zleceń ani przenosić środków.

Konfiguracja zajmuje około dziesięciu minut. W Interactive Brokers tworzysz trzy elementy i wklejasz je do Tradeways:

ElementJak wyglądaDo czego służy
Token Flex Web ServiceDługa liczba, około 25 cyfrPozwala Tradeways pobierać Twoje raporty
ID Activity Flex QueryKrótka liczba, około 7 cyfrRaport dzienny: korekty, prowizje, otwarte pozycje
ID Trade Confirmation Flex QueryKrótka liczba, około 7 cyfrRaport z bieżącego dnia: nowe realizacje

Wszystko znajdziesz w Interactive Brokers w sekcji Performance & Reports → Flex Queries. Poniższe obrazy pochodzą z aplikacji mobilnej Interactive Brokers, w której ta strona nazywa się Trade Reports. Client Portal na komputerze pokazuje te same pola.

Aby zaimportować historię sprzed połączenia albo importować bez tokenu, zobacz import pliku Interactive Brokers.

Skonfiguruj Interactive Brokers

1. Włącz Flex Web Service i utwórz token

Otwórz Flex Queries i wybierz ikonę koła zębatego obok Flex Web Service Configuration.

Konfiguracja Flex Web Service: włącz usługę, pozostaw adres IP pusty, wygeneruj nowy token

  1. Włącz Flex Web Service Status.
  2. Pozostaw pole Valid for IP Address puste. Tradeways nie łączy się ze stałego adresu, więc token ograniczony do adresu IP zostanie odrzucony.
  3. Wybierz Generate New Token i określ, jak długo token ma być ważny. Najdłuższy okres oszczędza Ci szybkiej wymiany.

Skopiuj token. Wygenerowanie kolejnego tokenu unieważnia ten; wtedy zastąp dane uwierzytelniające w Tradeways.

2. Utwórz dwa Flex Query

Na stronie Flex Queries każdy typ zapytania ma własny przycisk +.

Strona Flex Queries z przyciskami + dla Activity Flex Query i Trade Confirmation Flex Query

Activity Flex Query (1). W niemieckim portalu jest to Kontoumsatz-Flex-Query.

  1. Nadaj mu nazwę, na przykład Tradeways.
  2. Dodaj sekcję Trades. Jako poziom szczegółowości wybierz Executions i zaznacz wszystkie pola.
  3. Dodaj sekcję Open Positions. Jako poziom szczegółowości wybierz Summary i zaznacz wszystkie pola.
  4. Ustaw format XML. Okres nie ma znaczenia: Tradeways ustawia daty przy każdym żądaniu.
  5. Ustaw konfigurację ogólną zgodnie z krokiem 3, a następnie zapisz.

Trade Confirmation Flex Query (2). W niemieckim portalu jest to Handelsbestätigungs-Flex-Query.

  1. Nadaj mu nazwę, na przykład Tradeways.
  2. Dodaj sekcję Trade Confirmation. Jako poziom szczegółowości wybierz Execution i zaznacz wszystkie pola.
  3. Ustaw format XML.
  4. Ustaw konfigurację ogólną zgodnie z krokiem 3, a następnie zapisz.

Każde zapytanie może obejmować kilka kont Interactive Brokers. Nie potrzebujesz osobnego zapytania dla każdego konta; Tradeways zapyta, dokąd trafia każde konto, gdy zobaczy je po raz pierwszy.

3. Ustaw konfigurację ogólną w obu zapytaniach

Oba zapytania mają blok General Configuration. Ustaw w każdym te same cztery wartości.

General Configuration z formatem daty, formatem czasu ze strefą czasową, średnikiem jako separatorem oraz parami transakcji i anulowań ustawionymi na Yes

  1. Date Format: yyyyMMdd.
  2. Time Format: HHmmss TimeZone. To ustawienie najłatwiej pominąć. Bez niego czasy realizacji nie zawierają strefy czasowej, a Tradeways nie importuje raportu, w którym musiałby zgadywać czas.
  3. Date/Time Separator: ; (semi-colon).
  4. Include Offsetting Trade/Cancel Pairs?: Yes. Realizacja anulowana przez Interactive Brokers jest wtedy usuwana także z Twojego Dziennika.

Pozostaw Profit and Loss ustawione na Default. Pozostałe opcje możesz zostawić bez zmian.

4. Skopiuj oba identyfikatory zapytań

Otwórz każde zapytanie. Jego Query ID jest widoczny na górze szczegółów.

Szczegóły Activity Flex Query z Query ID na górze

Identyfikatory zapytań muszą być różne. Token jest znacznie dłuższy niż identyfikator zapytania, dzięki czemu łatwo odróżnić te trzy wartości.

Połącz w Tradeways

  1. Przejdź do Ustawienia → Integracje i znajdź Interactive Brokers.
  2. Wybierz Połącz Interactive Brokers.
  3. Wklej token w polu Token Flex Web Service, identyfikator zapytania Activity w polu ID zapytania Activity, a identyfikator zapytania Trade Confirmation w polu ID zapytania Trade Confirmation. Wybierz Połącz.
  4. Tradeways sprawdza token i oba zapytania. Interactive Brokers może potrzebować kilku minut na wygenerowanie raportów. Możesz zamknąć okno; status zaktualizuje się w Ustawieniach.
  5. Gdy raporty zawierają konta Interactive Brokers, przypisz każde z nich do osobnego konta Tradeways albo wybierz Nie importuj. Dla konta, które nie zostało przypisane, nic nie jest importowane.

Token jest przechowywany w postaci zaszyfrowanej i nigdy więcej nie jest pokazywany. Numery kont Interactive Brokers są wyświetlane w formie zamaskowanej.

Gdy pierwsza synchronizacja zaimportuje jakiekolwiek dane, przypisane konto zachowuje swoje konto docelowe. Możesz je wykluczyć i później dołączyć ponownie, ale tylko do tego samego konta Tradeways. Przeniesienie zaimportowałoby tę samą historię na drugie konto.

Jak działa synchronizacja

Synchronizacja automatyczna nie jest kanałem w czasie rzeczywistym. Interactive Brokers publikuje raporty Flex z opóźnieniem, a Tradeways odczytuje je według harmonogramu:

  • Nowe realizacje: zapytanie Trade Confirmation jest sprawdzane mniej więcej co 15 minut. Nowe wypełnienia pojawią się w Dzienniku w ciągu około 10–20 minut.
  • Korekty i otwarte pozycje: zapytanie Activity jest sprawdzane raz dziennie. Uwzględnia spóźnione realizacje, skorygowane prowizje oraz ceny zamknięcia z danego dnia dla otwartych pozycji.
  • Pierwsza synchronizacja: obejmuje ostatnie 365 dni kalendarzowych. Starsza historia pochodzi z importu pliku.

Wybierz Synchronizuj teraz, aby zażądać wcześniejszego sprawdzenia. Żądania są ograniczone do jednego na 15 minut.

Realizacje są dopasowywane według identyfikatora realizacji Interactive Brokers. Wypełnienie, które jest już w Dzienniku, z wcześniejszego raportu lub z importu pliku, nie zostanie zaimportowane dwukrotnie. Usunięty przez Ciebie Trade pozostaje usunięty, nawet jeśli późniejszy raport znów zawiera jego wypełnienia.

Co jest importowane

  • Realizacje akcji i ETF-ów oraz realizacje Forex CASH, które Interactive Brokers oznacza jako otwierające lub zamykające. Inne klasy aktywów są liczone jako nieobsługiwane i pomijane.
  • Częściowe wypełnienia, odwrócenia pozycji i prowizje zgodnie z raportem Interactive Brokers, w tym zwroty prowizji.
  • Anulowania: anulowana realizacja jest usuwana z Trade'u, do którego należała.
  • Bieżący P&L otwartych pozycji w akcjach i ETF-ach, liczony z dziennej ceny zamknięcia (MarkPrice) z raportu Activity. To nie jest notowanie na żywo.

Metryki odchyleń i inne analizy oparte na cenach pojawiają się tylko dla instrumentów z obsługiwaną historią cen. Pozostałe Trade'y są importowane bez nich; Tradeways ich nie szacuje.

Luki w historii

Realizacja zamykająca wymaga realizacji otwierającej. Gdy realizacja otwierająca jest starsza niż zsynchronizowany okres i nie ma jej jeszcze w Dzienniku, Tradeways pomija realizację zamykającą i liczy ją jako lukę w historii. Nie tworzy zastępczego wypełnienia otwierającego. Aby zamknąć lukę, zaimportuj plik obejmujący obie realizacje na to samo konto.

Status i liczniki

Każde połączenie w Ustawieniach pokazuje swój status, ostatnie sprawdzenie, ostatnie udane sprawdzenie i następne zaplanowane sprawdzenie, w Twojej strefie czasowej.

StatusZnaczenie
SprawdzanieRaport jest żądany lub przetwarzany.
Wybierz kontaZnaleziono nowe konta Interactive Brokers. Przypisz je lub wyklucz, aby kontynuować.
AktywneOstatnie sprawdzenie zakończyło się powodzeniem.
Aktywne, pominięto wierszeOstatni raport został zaimportowany, ale część wierszy wymaga sprawdzenia i została pominięta. Synchronizacja trwa dalej.
Opóźnione, ponawianieInteractive Brokers był niedostępny. Tradeways ponawia próbę automatycznie.
Wymagane działanieToken, zapytanie lub format raportu wymaga uwagi. Synchronizacja jest zatrzymana, dopóki tego nie naprawisz. Komunikat podaje, co.

Liczniki opisują ostatni raport: zaimportowane realizacje, pominięte jako duplikaty, usunięte jako anulowane, pominięte jako nieobsługiwane oraz pominięte jako luki w historii. Ponieważ dzienny raport Activity zachodzi na poprzednie dni, większość jego realizacji jest liczona jako duplikaty. To oczekiwane zachowanie.

Rozwiązywanie problemów

Komunikat lub objawCo zrobić
Token Flex wygasłWygeneruj nowy token w kroku 1, a następnie wybierz Zastąp dane uwierzytelniające.
Token Flex jest ograniczony do wybranych adresów IPWygeneruj token, pozostawiając pole Valid for IP Address puste.
Identyfikator zapytania Flex jest nieprawidłowySprawdź, czy każdy identyfikator jest we właściwym polu i czy zapytania Activity i Trade Confirmation nie zostały zamienione miejscami.
Nie udało się odczytać raportuUstaw format obu zapytań na XML.
Nie udało się odczytać niektórych wierszy tego raportuUstaw format czasu w obu zapytaniach na HHmmss TimeZone i zaznacz wszystkie pola w każdej sekcji. Czasy realizacji muszą mieć sufiks US Eastern, EST lub EDT.
Nowe wypełnienia pojawiają się dopiero następnego dniaZapytanie Trade Confirmation ich nie zwraca. Sprawdź jego sekcję i konfigurację ogólną.
Konto jest już połączone przez inny token FlexUsuń konto z jednego z zapytań albo rozłącz drugie połączenie.
Raport jest zbyt dużyZaimportuj starszą historię z pliku. Jeśli nowe realizacje przestaną docierać, skontaktuj się ze wsparciem.

Po naprawieniu tokenu lub zapytania w Interactive Brokers wybierz Zastąp dane uwierzytelniające, aby sprawdzić ponownie. Gdy konto docelowe jest niedostępne, wybierz Przypisz konta. Rozłącz zatrzymuje wszystkie sprawdzenia i usuwa token; już zaimportowane Trade'y zostają na Twoich kontach.

On this page