Interactive Brokers

Interactive Brokers

Verbind Interactive Brokers eenmalig en Tradeways importeert je uitvoeringen automatisch. Er is niets te installeren en je computer hoeft niet aan te staan: Tradeways downloadt de Flex-rapporten die je bij Interactive Brokers hebt ingesteld volgens een schema.

De verbinding is alleen-lezen. Met een Flex Web Service-token kunnen alleen de Flex-rapporten worden gedownload die je hebt ingesteld. Er kunnen geen orders worden geplaatst en geen geld worden overgemaakt.

De installatie duurt ongeveer tien minuten. Je maakt drie dingen aan bij Interactive Brokers en plakt ze in Tradeways:

Alles staat bij Interactive Brokers onder Performance & Reports → Flex Queries. De afbeeldingen hieronder komen uit de mobiele app van Interactive Brokers, waar deze pagina Trade Reports heet. Het Client Portal op desktop toont dezelfde velden.

Om historie van vóór de verbinding binnen te halen, of om te importeren zonder token, zie Bestandsimport voor Interactive Brokers.

Interactive Brokers instellen

1. Zet de Flex Web Service aan en maak een token

Open Flex Queries en selecteer het tandwielpictogram naast Flex Web Service Configuration.

1. Zet Flex Web Service Status aan.
2. Laat Valid for IP Address leeg. Tradeways verbindt niet vanaf een vast adres, dus een token dat tot een IP-adres is beperkt, wordt geweigerd.
3. Selecteer Generate New Token en kies hoe lang het geldig blijft. Met de langste periode hoef je het niet snel te vervangen.

Kopieer het token. Als je later een ander token genereert, wordt dit token ongeldig; vervang in dat geval de inloggegevens in Tradeways.

2. Maak de twee Flex Queries

Op de pagina Flex Queries heeft elk querytype een eigen +-knop.

Activity Flex Query (1). In het Duitse portal is dit de Kontoumsatz-Flex-Query.

1. Geef de query een naam, bijvoorbeeld Tradeways.
2. Voeg het gedeelte Trades toe. Kies Executions als detailniveau en selecteer alle velden.
3. Voeg het gedeelte Open Positions toe. Kies Summary als detailniveau en selecteer alle velden.
4. Stel de indeling in op XML. De periode maakt niet uit: Tradeways stelt de datums bij elk verzoek in.
5. Stel de algemene configuratie in zoals beschreven in stap 3 en sla de query op.

Trade Confirmation Flex Query (2). In het Duitse portal is dit de Handelsbestätigungs-Flex-Query.

1. Geef de query een naam, bijvoorbeeld Tradeways.
2. Voeg het gedeelte Trade Confirmation toe. Kies Execution als detailniveau en selecteer alle velden.
3. Stel de indeling in op XML.
4. Stel de algemene configuratie in zoals beschreven in stap 3 en sla de query op.

Elke query kan meerdere Interactive Brokers-accounts bevatten. Je hebt geen query per account nodig; Tradeways vraagt waar elk account naartoe gaat zodra het dit voor het eerst ziet.

3. Stel de algemene configuratie in beide queries in

Beide queries hebben een blok General Configuration. Stel in elke query dezelfde vier waarden in.

1. Date Format: yyyyMMdd.
2. Time Format: HHmmss TimeZone. Deze instelling mis je het gemakkelijkst. Zonder deze instelling hebben uitvoeringstijden geen tijdzone en importeert Tradeways geen rapport waarvan het de tijden zou moeten raden.
3. Date/Time Separator: ; (semi-colon).
4. Include Offsetting Trade/Cancel Pairs?: Yes. Een uitvoering die Interactive Brokers annuleert, wordt dan ook uit je journaal verwijderd.

Laat Profit and Loss op Default staan. De andere opties kunnen blijven zoals ze zijn.

4. Kopieer beide query-ID's

Open elke query. Het Query ID staat bovenaan de details.

De twee query-ID's moeten verschillen. Het token is veel langer dan een query-ID, waardoor de drie waarden gemakkelijk uit elkaar te houden zijn.

Verbinden in Tradeways

1. Ga naar Instellingen → Integraties en zoek Interactive Brokers.
2. Selecteer Interactive Brokers verbinden.
3. Plak het token in Flex Web Service-token, het Activity-query-ID in Query-ID Activity en het Trade Confirmation-query-ID in Query-ID Trade Confirmation. Selecteer Verbinden.
4. Tradeways controleert het token en beide queries. Interactive Brokers kan een paar minuten nodig hebben om de rapporten te genereren. Je kunt het venster sluiten; de status wordt bijgewerkt in Instellingen.
5. Zodra de rapporten Interactive Brokers-accounts bevatten, koppel je elk account aan een eigen Tradeways-account, of kies je Niet importeren. Voor een account wordt niets geïmporteerd totdat het is gekoppeld.

Het token wordt versleuteld opgeslagen en nooit meer getoond. Interactive Brokers-accountnummers worden gemaskeerd getoond.

Nadat de eerste synchronisatie iets heeft geïmporteerd, behoudt een gekoppeld account zijn bestemming. Je kunt het uitsluiten en later weer opnemen, maar alleen in hetzelfde Tradeways-account. Als je het verplaatst, wordt dezelfde historie in een tweede account geïmporteerd.

Hoe synchronisatie werkt

Automatische synchronisatie is geen realtimefeed. Interactive Brokers publiceert Flex-rapporten met vertraging en Tradeways leest ze volgens een schema:

• Nieuwe uitvoeringen: de Trade Confirmation-query wordt ongeveer elke 15 minuten gecontroleerd. Verwacht nieuwe uitvoeringen binnen ongeveer 10 tot 20 minuten in je journaal.
• Correcties en open posities: de Activity-query wordt één keer per dag gecontroleerd. Die pikt late uitvoeringen, gecorrigeerde commissies en de slotkoersen van de dag voor open posities op.
• Eerste synchronisatie: beslaat de laatste 365 kalenderdagen. Oudere historie komt uit een bestandsimport.

Selecteer Nu synchroniseren om een vroege controle aan te vragen. Aanvragen zijn beperkt tot één per 15 minuten.

Uitvoeringen worden gekoppeld via hun uitvoerings-ID van Interactive Brokers. Een uitvoering die al in je journaal staat, uit een eerder rapport of uit een bestandsimport, wordt niet twee keer geïmporteerd. Een trade die je verwijdert, blijft verwijderd wanneer een later rapport de bijbehorende uitvoeringen opnieuw bevat.

Wat wordt geïmporteerd

• Uitvoeringen van aandelen en ETF's, en CASH-forexuitvoeringen die Interactive Brokers markeert als openend of sluitend. Andere activaklassen worden geteld als niet ondersteund en overgeslagen.
• Gedeeltelijke uitvoeringen, positieomkeringen en commissies zoals Interactive Brokers ze rapporteert, inclusief commissieterugbetalingen.
• Annuleringen: een geannuleerde uitvoering wordt verwijderd uit de trade waartoe ze behoorde.
• Lopende P&L op open posities in aandelen en ETF's, op basis van de dagelijkse slotkoers (MarkPrice) in het Activity-rapport. Het is geen live koers.

Excursiestatistieken en andere op koersen gebaseerde analyse verschijnen alleen voor instrumenten met ondersteunde koershistorie. Andere trades worden zonder deze gegevens geïmporteerd; Tradeways schat ze niet.

Gaten in de historie

Een sluitende uitvoering heeft een openende uitvoering nodig. Wanneer de openende uitvoering ouder is dan de gesynchroniseerde periode en niet al in je journaal staat, slaat Tradeways de sluitende uitvoering over en telt die als gat in de historie. Er wordt geen vervangende openende uitvoering gemaakt. Om het gat te dichten, importeer je een bestand dat beide uitvoeringen bevat in hetzelfde account.

Status en aantallen

Elke verbinding in Instellingen toont de status, de laatste controle, de laatste geslaagde controle en de volgende geplande controle, in jouw tijdzone.

De aantallen beschrijven het laatste rapport: geïmporteerde uitvoeringen, als duplicaat overgeslagen, als geannuleerd verwijderd, als niet ondersteund overgeslagen en als gat in de historie overgeslagen. Omdat het dagelijkse Activity-rapport overlapt met de voorgaande dagen, worden de meeste uitvoeringen erin als duplicaat geteld. Dat is normaal.

Problemen oplossen

Nadat je het token of een query bij Interactive Brokers hebt hersteld, selecteer je Inloggegevens vervangen om opnieuw te controleren. Wanneer een bestemmingsaccount niet beschikbaar is, selecteer je Accounts koppelen. Loskoppelen stopt alle controles en verwijdert het token; al geïmporteerde trades blijven in je accounts staan.