{"id":175501,"date":"2020-08-28T15:05:00","date_gmt":"2020-08-28T19:05:00","guid":{"rendered":"https:\/\/ibkrcampus.com\/trading-lessons\/installing-configuring-tws-for-the-api\/"},"modified":"2024-07-02T11:38:45","modified_gmt":"2024-07-02T15:38:45","slug":"installing-configuring-tws-for-the-api","status":"publish","type":"trading-lessons","link":"https:\/\/www.interactivebrokers.com\/campus\/trading-lessons\/installing-configuring-tws-for-the-api\/","title":{"rendered":"Installing & Configuring TWS for the API"},"content":{"rendered":"\n

In order to use the TWS API, clients must download and install the Trader Workstation or IB Gateway. All Interactive Brokers resources are linked in our documentation. If a user visits our IBKR Campus documentation, navigate to the TWS API directory. On this page, we will see a designated section for Download TWS or IB Gateway<\/strong>. Clicking the affiliated link will bring you to an affiliated downloads page.<\/p>\n\n\n\n

On the download page for Trader Workstation you\u2019ll notice that there are \u2018Online\u2019 versions which update automatically with new releases, as well as \u2018Offline\u2019 versions at the bottom which never update. When you go to the site, the server will automatically detect the operating system of your browser and provide the corresponding download automatically, however all versions of TWS are available for use with Windows, Linux, or Mac.<\/p>\n\n\n\n

IB Gateway<\/h4>\n\n\n\n

The alternative to using TWS for API users is to use a program called IB Gateway. From an API perspective, IB Gateway is nearly identical to TWS. Any application that connects to and uses the API with TWS can also use IB Gateway. Please be aware that in this tutorial series, we will be working with and referencing Trader Workstation. However, please note that the two are synonymous, and the whole series can be followed using either application.<\/p>\n\n\n\n

The major difference of IB Gateway is that it is entirely geared towards API functionality and does not provide access to account information via a GUI in the same way as TWS does. Because of this, it is a smaller application that requires fewer resources.<\/p>\n\n\n\n

Equivalent versions of TWS and IB Gateway are always released together. For instance, if the current TWS Latest version is 10.19.1c, then the current IB Gateway Latest build is also 10.19.1c.<\/p>\n\n\n\n

After deciding which application to run, users can download their given platform. Please be aware for Windows, MacOS, and Linux, after selecting your download option, Interactive will display exact platform specific instructions for this installation process.<\/p>\n\n\n\n

Installing TWS for Windows or MacOS<\/strong><\/h4>\n\n\n\n

For all platforms, we will assume the download will appear in our respective Downloads folder. For Windows, we should have a .exe file while MacOS will be provided with a .dmg. Clicking these executables should launch an identical Install Wizard. In our case, we can simply follow our default values and click \u201cNext\u201d throughout the program. This will install the Trader Workstation to a directory on C:\\Jts. TWS will be installed locally, and a new icon will be created on the desktop. \u00a0<\/p>\n\n\n\n

Installing TWS for Linux<\/strong><\/h4>\n\n\n\n

The process to install the Trader Workstation on Linux is only slightly different compared to the Windows and MacOS counterparts. For Linux distributions, after downloading the software, users will need to navigate to the corresponding Downloads directory in their terminal to find the program installer. Then, we can call chmod u+x<\/strong> on the sh file to allow the user to execute it. After updating the file\u2019s permissions, we can call sudo .\/tws-stable-standalone-linux.sh<\/strong> to run the executable and display an identical install wizard. Once again, we will follow the default install directory. In my case, it should be installed under my user directory.<\/p>\n\n\n\n

Assuming I do not have a corresponding GUI for launching my applications, I can manually run the Trader Workstation by calling the launcher located with .\/Jts\/1019\/tws<\/strong>. Users may find a different version number aside from 1019 in their installation.<\/p>\n\n\n\n

Configuring Trader Workstation<\/strong><\/h4>\n\n\n\n

Launching the Trader Workstation will bring up the TWS login screen which has inputs for a username and password. There is also an option where you can select to login to either your live or paper account. Paper accounts are compatible to use with the TWS API, and it is recommended to test all programs in a paper environment before moving to production trading.<\/p>\n\n\n\n

If you don\u2019t have an IB account, it\u2019s possible to login to a demo account by clicking the link \u201cTry the Demo\u201d<\/strong> and using an email address instead.<\/p>\n\n\n\n

To receive live or historical data from the API, it is necessary to first have live data permissions enabled in TWS. For most instrument types, this requires first having a live funded account with active market data subscriptions.<\/p>\n\n\n\n

After you fully logged into TWS and it has loaded completely for the first time, there is a setting which must be enabled to allow the API connection, and several others which some users decide to configure differently for their applications. The API settings can be configured in the Global Configuration. For Trader Workstation, select the cog wheel in the top right corner. IB Gateway users should see an option for \u201cConfigure\u201d and \u201cSettings\u201d to launch the same window.<\/p>\n\n\n\n

After entering the Global Configuration, users can navigate to API<\/strong> then Settings<\/strong> on the left. The setting necessary to enable the socket client connections for Python is the first checkbox labelled \u201cEnable ActiveX and Socket Clients<\/strong>\u201d. The other settings which affect the initial connection are:<\/p>\n\n\n\n