Die Trader Workstation und das IB Gateway von Interactive Brokers bieten eine lokale Programmierschnittstelle: Eine Anwendung auf demselben Rechner verbindet sich mit einem Socket-Port und fragt darüber Ausführungen, Positionen, Kontowerte und Marktdaten ab. Die Verbindung verlässt den Rechner nicht, die TWS selbst spricht mit den IBKR-Servern.
Standardmässig ist die API ausgeschaltet. Die Freischaltung ist eine einmalige Einstellung in der TWS, die auch nach Updates erhalten bleibt. Die API kann nur mit laufender TWS genutzt werden. Für den täglichen Import ohne TWS gibt es den Flex Web Service, die TWS-API ist der Weg für Echtzeitdaten, Kurse und Paper-Trading-Konten.
Schritt für Schritt
-
1
Globale Konfiguration öffnen
In der TWS das Menü Bearbeiten (Edit), dann Globale Konfiguration (Global Configuration) öffnen. Im IB Gateway heisst der Weg Configure, Settings.
-
2
API-Einstellungen aufrufen
In der linken Spalte API, dann Settings wählen. Hier stehen alle Optionen für Verbindungen von Drittanwendungen.
-
3
Verbindung freischalten
Diese Einstellungen setzen:
-
Enable ActiveX and Socket Clients: aktivieren. Ohne dieses Häkchen nimmt die TWS keine Verbindung an.
-
Read-Only API: aktiviert lassen (Standard). Eine Journal-Software liest nur, sie platziert keine Orders.
-
Socket port: Standard ist 7496 für Live-Konten und 7497 für Paper-Trading. Denselben Port in der Software eintragen.
-
Allow connections from localhost only: aktiviert lassen (Standard). Nur Anwendungen auf demselben Rechner dürfen sich verbinden.
-
Send API messages in English: aktivieren, falls die TWS in einer anderen Sprache läuft. Die Option ist nur dann sichtbar.
-
-
4
Übernehmen und Verbindung testen
Mit Apply und OK bestätigen. Beim ersten Verbindungsaufbau einer Software zeigt die TWS ein Dialogfenster, in dem du die Verbindung erlaubst. Wer Trusted IP Addresses mit 127.0.0.1 ergänzt, sieht diesen Dialog nicht mehr.
-
5
Client ID beachten
Jede Anwendung, die gleichzeitig mit der TWS verbunden ist, braucht eine eigene Client ID. Läuft neben dem Journal noch ein anderes Tool über die API, dürfen sich die IDs nicht überschneiden, sonst wird eine der Verbindungen abgewiesen.
Gut zu wissen
- Die API liefert nur, solange die TWS oder das Gateway läuft und angemeldet ist.
- Marktdaten über die API setzen die entsprechenden Marktdatenabonnements im IBKR-Konto voraus. Ohne Abonnement kommen verzögerte oder keine Kurse.
- Paper-Trading-Konten haben keinen Flex Web Service. Für sie ist die TWS-API oder der CSV-Import der einzige Importweg.
- Auf macOS mit Apple Silicon stürzt die TWS in einigen Versionen beim Verschieben von Fenstern ab. Abhilfe schafft die Einstellung os_titlebar=false in der Datei jts.ini im Ordner Jts.
Häufige Fragen
Kann eine Software über die API Orders in meinem Konto platzieren?
Nur wenn Read-Only API abgeschaltet ist. Mit aktivierter Read-Only-Einstellung liefert die TWS ausschliesslich Daten und weist jeden Orderversuch ab. Für ein Journal ist Read-Only ausreichend.
TWS oder IB Gateway?
Beide bieten dieselbe API. Das Gateway braucht weniger Speicher und hat keine Handelsoberfläche, die TWS zeigt Charts und Orders. Für ein Journal ist es egal. Wer ohnehin in der TWS handelt, nimmt die TWS.
Welcher Port ist richtig?
7496 für Live-Konten, 7497 für Paper-Trading, jeweils der Standard der TWS. Das IB Gateway verwendet 4001 und 4002. Der Port in der Software muss mit dem in der TWS übereinstimmen.
Funktioniert die TWS-API bei Introducing Brokern wie CapTrader oder LYNX?
Ja. Introducing Broker auf IBKR-Infrastruktur stellen dieselbe Trader Workstation bereit, die Einstellungen sind identisch.