Locating Portfolio Page

The portfolio page allows you to view and montor your current portfolio at the individual position level, including psoition quantity, market value, current bid-ask and profit/loss. Instructions for locating the page vary by trading platform and are outlined below:

TWS Classic - First check to see if you have detached the page from the main window (an option provided by right clicking on the tab). If this is the case, the page will be open but hidden behind the main window. Minimize the main window by clicking on the minimize icon located in the upper-right hand corner of the screen. If you are able to then view the portfolio page and wish to reattach it, simply right click on the tab to open the menu and select the "Attach Page" option.

If the page is not detached, select the "Account Window" option from the top menu bar and then "Portfolio Window" menu option.

 

Mosiac - from the Montor window, click on the small + sign located to the right of any existing monitor tabs. Then select "Portfolio" and this page will reappear.

 

 

Additional Information Regarding the Use of Stop Orders

U.S. equity markets occasionally experience periods of extraordinary volatility and price dislocation. Sometimes these occurrences are prolonged and at other times they are of very short duration. Stop orders may play a role in contributing to downward price pressure and market volatility and may result in executions at prices very far from the trigger price. 

Investors may use stop sell orders to help protect a profit position in the event the price of a stock declines or to limit a loss. In addition, investors with a short position may use stop buy orders to help limit losses in the event of price increases. However, because stop orders, once triggered, become market orders, investors immediately face the same risks inherent with market orders – particularly during volatile market conditions when orders may be executed at prices materially above or below expected prices.
 
While stop orders may be a useful tool for investors to help monitor the price of their positions, stop orders are not without potential risks.  If you choose to trade using stop orders, please keep the following information in mind:
 
·         Stop prices are not guaranteed execution prices. A “stop order” becomes a “market order” when the “stop price” is reached and the resulting order is required to be executed fully and promptly at the current market price. Therefore, the price at which a stop order ultimately is executed may be very different from the investor’s “stop price.” Accordingly, while a customer may receive a prompt execution of a stop order that becomes a market order, during volatile market conditions, the execution price may be significantly different from the stop price, if the market is moving rapidly.
 
·         Stop orders may be triggered by a short-lived, dramatic price change. During periods of volatile market conditions, the price of a stock can move significantly in a short period of time and trigger an execution of a stop order (and the stock may later resume trading at its prior price level). Investors should understand that if their stop order is triggered under these circumstances, their order may be filled at an undesirable price, and the price may subsequently stabilize during the same trading day.
 
·         Sell stop orders may exacerbate price declines during times of extreme volatility. The activation of sell stop orders may add downward price pressure on a security. If triggered during a precipitous price decline, a sell stop order also is more likely to result in an execution well below the stop price.
 
·         Placing a “limit price” on a stop order may help manage some of these risks. A stop order with a “limit price” (a “stop limit” order) becomes a “limit order” when the stock reaches or exceeds the “stop price.” A “limit order” is an order to buy or sell a security for an amount no worse than a specific price (i.e., the “limit price”). By using a stop limit order instead of a regular stop order, a customer will receive additional certainty with respect to the price the customer receives for the stock. However, investors also should be aware that, because a sell order cannot be filled at a price that is lower (or a buy order for a price that is higher) than the limit price selected, there is the possibility that the order will not be filled at all. Customers should consider using limit orders in cases where they prioritize achieving a desired target price more than receiving an immediate execution irrespective of price.
 
·         The risks inherent in stop orders may be higher during illiquid market hours or around the open and close when markets may be more volatile. This may be of heightened importance for illiquid stocks, which may become even harder to sell at the then current price level and may experience added price dislocation during times of extraordinary market volatility. Customers should consider restricting the time of day during which a stop order may be triggered to prevent stop orders from activating during illiquid market hours or around the open and close when markets may be more volatile, and consider using other order types during these periods.
 
·         In light of the risks inherent in using stop orders, customers should carefully consider using other order types that may also be consistent with their trading needs.

How to start multiple TWS sessions on a Mac

Background: 

By default macOS does not allow the user to run multiple sessions of the same application. The following workaround can overcome this limitation in case you need to run the Trader Workstation for more than one user.

 

  • In case running different versions of the TWS is suitable to your needs, please follow the instructions on Procedure 1

  • In case you need multiple sessions of the same TWS version, please follow the instructions on Procedure 2

 

Procedure 1

1) Open the web page ibkr.com

2) Navigate to the menu Technology TWS Software.

3) First download and install one of the auto-updating TWS versions (TWS LATEST or TWS according to your preference).

4) Once you have completed the installation, download and install one of the offline versions (OFFLINE TWS LATEST or OFFLINE TWS according to your preference).

5) You will then see on your Desktop two different Trader Workstation icons. You can use the first shortcut to start the first TWS session and the second one to start the additional one (see Figure 1.). Note: the link containing the version number in the name is the OFFLINE version. This will be a version that needs periodical manual updates.

Figure 1.

 

 

 

 

Procedure 2

1) Launch the first session of the Trader Workstation using the TWS icon present on your Desktop. If you still do not have any Trader Workstation icon, please go to the web page ibkr.com and click on the menu Technology > TWS Software. Then download and install one of the TWS versions displayed.

2) Open the Finder and click on Applications on the left side menu. Then select Utilities and then launch Terminal (see Figure 2.).

Figure 2.

3) The Terminal will appear on the screen and will point to the home folder of your current macOS user. Then enter the commands listed below (see Figure 3.) on your Terminal. After each one, press ENTER on your keyboard.

cd Applications

cd Trader\ Workstation

open -n Trader\ Workstation.app

Figure 3.

4) The login window for your second TWS session will then appear on your Desktop. You can now close the Terminal.

 

Note: the procedure above presumes that the TWS executable is located in the following path: users/yourusername/home/Applications/Trader Workstation/Trader Workstation.app

If at the time you installed the TWS, you selected to install it for all the users of your system, then the TWS executable will be located here:

/Applications/Trader Workstation/Trader Workstation.app

and therefore you would need to issue the following commands in the Terminal:

cd /Applications

open -n Trader\ Workstation.app

 

How to overcome the warning message "The signature of the file is corrupt or invalid"

Overview: 

This article describes how to overcome the warning message which you might receive when you download the Trader Workstation or IB Gateway installation packages.

Background: 

Since a Microsoft update has modified the signature validation mechanisms, the Trader Workstation and IB Gateway installation packages might be reported as having an invalid or corrupt signature, although their signature is indeed intact and absolutely valid.

If you are using Microsoft Edge as browser please follow all the steps below. If you are using any other browser start directly from point 3.

 

1. As soon as the installation package has been completely downloaded, you will notice on the bar at the bottom of your browser frame the warning message "The signature of the file tws-... is corrupt or invalid". Please click on the button View Downloads to open the DOWNLOADS panel. 

 

2. Right click on the filename and select Run anyway.

 

 

3. Once the installer has been launched, the SmartScreen filter will display an additional warning message. Click on the link More Info.

 

4. Now click the button Run Anyway to allow the file execution. The installation will then start.

How to install Java on a Linux computer

Overview: 
This article will walk you through the process of installing the official Oracle Java platform on your Linux machine.
 
Background: 
There are many Linux distributions available and many of them come with one or more Java platform/s pre-installed. In the vast majority of the cases the Java platform which comes pre-installed on a Linux machine is not the official Oracle Java, but another one such as OpenJKD or IBM Java. 
The Trader Workstation has been developed on the official Oracle Java platform and shows the most stable behavior and the best performances when run by the official Oracle Java process. Therefore we recommend to all the Linux users, who want to run the Trader Workstation, to install the official Oracle Java platform and set it as the preferred Java environment to be used by the operating system.
 

For the purpose of this guide, we will divide the Linux distributions nowadays available into three big families:

  1. APT based Linux distributions (Ubuntu, Mint) - those distributions use the Advanced Packaging Tool to fetch and install software packages in a semi-automatic way, resolving and taking care of dependencies. 
  2. RPM based Linux distributions (Suse, OpenSUSE, Red Hat, CentOS, Fedora, Oracle Linux) - those distributions allow the installation of software packages (.rpm files), which contain the binary files to be installed on the system and an integrated dependency checker script. The .rpm packages allow a simplified and smooth installation of software without requiring a deep knowledge of the system.
  3. Other Linux distributions  - those distributions may or may not use a specific package manager but all of them allow the installation of software using the source code package (.tar.gz) through a series of command to be issued on the Terminal.

 

How to install the official Oracle Java on APT based Linux distributions

The most simple way to install Java on Ubuntu or Mint is using the webupd8 repository. This method will install the latest version of JDK 8 and the JRE 8 browser plugin. The supported versions are: Ubuntu 15.04, 14.10, 14.04, 12.04 - Linux Mint 17.1, 17, 13

For details, please refer to: http://www.webupd8.org/2012/09/install-oracle-java-8-in-ubuntu-via-ppa.html

a. On your Linux machine, open the "Terminal". If you need help with accessing and using the Terminal, please refer to: https://help.ubuntu.com/community/UsingTheTerminal

b. Become root, by typing su on the Terminal and entering the super user password. Instead of becoming root, you can choose to use the sudo feature (which gives your user the root privileges for a single command). If you want to use sudo, just add sudo before each one of the commands you will enter in the Terminal. You will be requested to enter the sudo password.

c. Add the webupd8 repository by tiping add-apt-repository ppa:webupd8team/java Follow the instructions on the screen. You should be asked to press [ENTER] to continue. Once done, the repository will be added.

d. Type the command apt-get update

e. Enter the command: apt-get install oracle-java8-installer The process will download and install automatically the required packages along with their dependencies. Once the command has completed, the Oracle Java platform will be ready to be used.

Should you prefer to have control of all the phases of the installation, instead of relying on the APT facility, please refer to the instructions on this page: http://www.wikihow.com/Install-Oracle-Java-JRE-on-Ubuntu-Linux

 

How to install the official Oracle Java on RPM based Linux distributions

a. On your Linux machine, open the "Terminal". If you need help with accessing and using the Terminal, please refer to: https://help.ubuntu.com/community/UsingTheTerminal

b. Become root, by typing su on the Terminal and entering the super user password. Instead of becoming root, you can choose to use the sudo feature (which gives your user the root privileges for single commands). If you want to use sudo, just add sudo before each one of the commands you will enter in the Terminal. You will be requested to enter the sudo password.

c. Create the folder /usr/java by issuing the command mkdir /usr/java. If the directory already exists you will see a message indicating that. In this case you can proceed directly to point d.

d. Go to the page https://www.java.com/en/download/linux_manual.jsp

e. If you have a 32 bit system, download the file "Linux RPM" . If you have a 64 bit system, download the file "Linux64 RPM". In either case, please instruct your browser to save the file in the folder /usr/java or move the file to that foder once it has been downloaded.

f. Go back to the Terminal and move to the /usr/java folder by typing cd /usr/java

g. List the content of the folder by typing the command ls -la You should see the file you downloaded. It will be called jre-XuYY-linux-ARCH.rpm (where X is the Java family, YY the update number and ARCH will be i586 for 32 bit installer and x64 for 64 bit installer)

h.  Launch this command to perform the installation: rpm -ivh jre-XuYY-linux-ARCH.rpm  Obviously you need to use the real file name, for example jre-8u65-linux-x64.rpm

Once the installation has been performed, the Oracle Java should be ready to be used. Usually a system restart is not required on Linux machines. In case you see warning or error message/s during the installation, please check their content and search the Internet for possible solutions. Most of the time the warning/error messages maight refer to missing dependencies (this means that another package needs to be installed before you can install Java) or to unsufficient privileges (this means that you are launching the command with a regular user instead of "root"). If you cannot find the proper course of actions to overcome the issue, please refer to the support documentation or forums for your current Linux distribution.

 

How to install the official Oracle Java on other Linux distributions

If your Linux distribution does not support RPM or APT package managers, the installation of Oracle Java can be performed manually in this way:

a. On your Linux machine, open the "Terminal".

b. Become root, by typing su on the Terminal and entering the super user password. Instead of becoming root, you can choose to use the sudo feature (which gives your user the root privileges for single commands). If you want to use sudo, just add sudo before each one of the commands you will enter in the Terminal. You will be then required to enter the sudo password.

c. Create the folder /usr/java by issuing the command mkdir /usr/java. If the directory already exists you will see a message indicating that. In this case you can proceed directly to point d.

d. Go to the page https://www.java.com/en/download/linux_manual.jsp

e. If you have a 32 bit system, download the file "Linux" . If you have a 64 bit system, download the file "Linux x64". In either case, please instruct your browser to save the file in the folder /usr/java or move the file to that foder once it has been downloaded.

f. Go back to the Terminal and move to the /usr/java folder by typing cd /usr/java

g. List the content of the folder by typing the command ls -la You should see the file you downloaded. It will be called jre-XuYY-linux-ARCH.tar.gz (where X is the Java family, YY the update number and ARCH will be i586 for 32 bit installer and x64 for 64 bit installer)

h.  Launch this command to perform the installation: tar zxvf jre-XuYY-linux-ARCH.tar.gz  Obviously you need to use the real file name, for example jre-8u65-linux-x64.tar.gz

i. Once done, enter command ls -la You will see the folder /usr/java/jre1.X.0_YY (where X is the Java family, YY the update number)

l.  The Java executables are now present in the folder /usr/java/jre1.X.0_YY/bin 

m. Now check which is the symbolic link used by the system to access the java executables by entering the commands:

which java  - you will receive an output similar to this: /usr/bin/java  From now on we will refer to this path as javasympath.

which javac  - you will receive an output similar to this: /usr/bin/java  From now on we will refer to this path as javacsympath.

which javaws  - you will receive an output similar to this: /usr/bin/java  From now on we will refer to this path as javawssympath.

Unless your are launching the java applications using the full path (for example /usr/java/jre1.X.0_YY/bin/java ...), you would need to tell your system which java executables should be used when a generic java command is issued. In order to to this, you can either update your alternatives files (if your system supports them) or the symbolic links. Here below you can see the instructions, according to your system:

- If your system uses the alternatives files:

n.  Issue the following commands, paying attention to make the necessary substitutions .

update-alternatives --install javasympath java /usr/java/jre1.X.0_YY/bin/java 1

update-alternatives --install javacsympath javac /usr/java/jre1.X.0_YY/bin/javac 1

update-alternatives --install javawssympath javaws /usr/java/jre1.X.0_YY/bin/javaws 1

- If your system does not use the alternatives files:

n. Issue the following commands, paying attention to make the necessary substitutions .

ln -sf  /usr/java/jre1.X.0_YY/bin/java javasympath

ln -sf /usr/java/jre1.X.0_YY/bin/javac javacsympath

ln -sf /usr/java/jre1.X.0_YY/bin/javaws javawssympath

 

Market Data Non-Professional Questionnaire

Overview: 

Insight into completing the new Non-Professional Questionnaire.

Background: 

The NYSE and most US exchanges require vendors to positively confirm the market data status of each customer before allowing them to receive market data. Going forward, the Non-Professional Questionnaire will be used to identify and positively confirm the market data status of all customer subscribers. As per exchange requirements, without positively identifying customers as non-professional, the default market data status will be professional. The process will protect and maintain the correct market data status for all new subscribers. For a short guide on non-professional definitions, please see https://ibkr.info/article/2369.

Each question on the questionnaire must be answered in order to have a non-professional designation. As exchanges require positive confirmations of proof for non-professional designations, an incomplete or unclear Non-Professional Questionnaire will result in a Professional designation until the status can be confirmed. 

If the status should change, please contact the helpdesk.

Explanation of questions:

1)    Commercial & Business purposes

a)    Do you receive financial information (including news or price data concerning securities, commodities and other financial instruments) for your business or any other commercial entity?

Explanation: Are you receiving and using the market data for use on behalf of a company or other organization aside from using the data on this account for personal use?

b)    Are you conducting trading of any securities, commodities or forex for the benefit of a corporation, partnership, professional trust, professional investment club or other entity?

Explanation: Are you trading for yourself only or are you trading on behalf of an organization (Ltd, LLC, GmbH, Co., LLP, Corp.)?

c)    Have you entered into any agreement to (a) share the profit of your trading activities or (b) receive compensation for your trading activities?

Explanation: Are you being compensated to trade or are you sharing profits from your trading activities with a third party entity or individual?

d)    Are you receiving office space, and equipment or other benefits in exchange for your trading or work as a financial consultant to any person, firm or business entity?

Explanation: Are you being compensated in any way for your trading activity by a third party, not necessarily by being paid in currency.

2)    Act in a capacity

a)    Are you currently acting in any capacity as an investment adviser or broker dealer?

Explanation: Are you being compensated to manage third party assets or compensated to advise others on how to manage their assets?

b)    Are you engaged as an asset manager for securities, commodities or forex?         
 

Explanation: Are you being compensated to manage securities, commodities, or forex?

c)     Are you currently using this financial information in a business capacity or for managing your employer’s or company’s assets?

Explanation: Are you using data at all for a commercial purposes specifically to manage your employer and/or company assets?

d)    Are you using the capital of any other individual or entity in the conduct of your trading?

Explanation: Are there assets of any other entity in your account other than your own?

3)    Distribute, republish or provide data to any other party

a)    Are you distributing, redistributing, publishing, making available or otherwise providing any financial information from the service to any third party in any manner?

Explanation: Are you sending any data you receive from us to another party in any way, shape, or form?

4)    Qualified professional securities / futures trader

a)    Are you currently registered or qualified as a professional securities trader with any security agency, or with any commodities or futures contract market or investment adviser with any national or state exchange, regulatory authority, professional association or recognized professional body? i, ii
YES☐             NO☐

i) Examples of Regulatory bodies include, but are not limited to,

  • US Securities and Exchange Commission (SEC)
  • US Commodities Futures Trading Commission (CFTC)
  • UK Financial Service Authority (FSA)
  • Japanese Financial Service Agency (JFSA)

ii) Examples of Self-Regulatory Organization (SROs) include, but are not limited to:

  • US NYSE
  • US FINRA
  • Swiss VQF 

How to restore TWS settings from external storage

Overview: 

This article outlines the procedure for restoring TWS settings from an external location, example external hard drive, USB or other file location.

To restore TWS settings from an external source:

1. Log into TWS

2. Click on File and select Settings Recovery

Menu: File -> Settings Recovery                                     

3. Select Custom and click on Ok

Settings Recovery options                                                                                                                    

4. In the Look in field click on the drop down menu and select the directory where the TWS settings file is stored, example; If the file was located on the Desktop you would scroll to Desktop as shown below

Choose settings file location                                                              

5. Once you are in the directory containing the settings file,  select the settings file, example tws.xml and click on Open.

Enter settings filename

6.  In the Open settings confirmation window select Open without reporting problem

settings confirmation

 

Related articles

See KB3146 for instructions on overcoming the "Downloading settings from server failed" error

See KB2320 for instructions on transferring settings from one user to another

See KB2282 for instructions on how to transfer settings from one computer to another

 

 

 

 

How to Transfer TWS Settings from One User to Another

Overview: 

Trader Workstation (TWS) layout settings files are part of a number of sensitive details that have recently being protected by encrypting them.

In this article, we will explain how to export a copy of your current TWS layout settings and load it on a different TWS session. You can use this same procedure to export the layout settings of your Paper (Simulated) TWS and load them on your Live TWS.

 

Please follow the below steps to transfer your TWS layout settings from one user to another:

1. Log in to TWS with the user whose settings you would like to export

2. Navigate to the top menu and select 'File' followed by 'Settings' > 'Save Settings'

3. A pop-up carrying the text The Settings have been saved will flash on the screen to confirm the success of the operation

4. Navigate to the top menu and select Help followed by Troubleshooting > Diagnostics > TWS Layout/Settings

5. The tws.xml window will appear. Click Export Settings…

6. A pop up will show the location of the exported settings file. Do NOT click OK yet. Instead, click one of the links here below, according to your Operating System

 

Windows

7.a) Left click on the beginning of the folder path and hold and drag the mouse to select the entire path. Please make sure you only select the path without the initial quotation mark ('), the final forward slash (/) and the file name, as shown on the example image below. Now press CTRL+C to copy the selection

7.b) Click OK and then, on tws.xml window, click Close

7.c) Press WIN+R to open the 'Run' panel

7.d) Press CTRL+V (or do a right mouse click and select Paste) to paste the folder path that you have previously copied. Press Enter on your keyboard

7.e) The content of the folder will be shown. Click on the top menu View and make sure that the File name extensions checkbox is active

7.f)  Right click on the file tws.xml.txt and rename it, using a filename of your choice and the .xml file extension (e.g. you can rename the file to: settings.xml)

7.g) If you are prompted to confirm the file extension change, click Yes

7.h) Proceed to Step 8) for further instructions

 

macOS

7.a) Left click on the beginning of the folder path and hold and drag the mouse to select the entire path. Please make sure you only select the path without the initial quotation mark (') , the final forward slash (/) and the file name, as shown on the example image below. Now press Command+C to copy the selection

7.b) Click OK and then, on tws.xml window, click Close

7.c) Press Command+Shift+G on your keyboard to open the Go to Folder panel

7.d) Press Command+V  (or do a right mouse click and select Paste) to paste the folder path that you have previously copied. Press Enter on your keyboard

7.e) The content of the folder will be shown. Rename the file tws.xml.txt using a filename of your choice and the .xml file extension (e.g. you can rename the file to: settings.xml)

7.f) If you are prompted to confirm the file extension change, click Use .xml

8. Close your TWS and launch it again (or open an additional TWS session). Log in with the user which should import the layout settings

9. Click the top menu File followed by Settings > Layout/Settings Recovery

10. Select Custom and click Ok

11. Put the cursor in the File Name field and press CTRL+V to paste the folder path you had previously copied at point 7.a). Click  Open

12. Select the settings file you previously renamed (e.g. settings.xml) and click Open

13. Click Open without reporting problem

14. Your TWS will automatically restart, loading the imported layout settings

 

References

See KB2323 for instructions on how to restore TWS settings from external storage

See KB2282 for instructions on how to transfer settings from one computer to another.

See KB3146 for instructions on how to overcome the "Download settings from server failed" error

How to transfer TWS settings from one computer to another

Overview: 

 This article applies to:

  • Platform(s): Windows, Mac, Linux
  • TWS Build(s): Build 959 and Above

 

Background: 

The 'Store Settings on Server' feature stores the Trader Workstation (TWS) settings/configuration in the cloud and retrieve them at anytime from another computer. This allows you to transfer settings from the same user on two different machines, but not between different accounts/users.

 
How to upload your TWS settings to the server:

To transfer settings from one computer to another for the same username you will need to enable the option Use/store settings on server:

1. On the computer which currently has your settings, on the lower right of the login window, click on More Options >TWS Login Screen

2. Make sure the Use/store settings on server option is unchecked and login

 3. Once you are logged in, enable this function:

  • If you are using the Classic layout, navigate to Edit >> Global Configuration >> Lock and Exit and check the box Use store settings on server
  • If you are using the Mosaic layout navigate to File >> Global Configuration >> Lock and Exit and check the box Use store settings on server

 Global Configurations Window

4.  Select Apply and OK.

5. Click on File -> Save Settings.

6. To Exit the application navigate to File and Exit.

IMPORTANT NOTE: The above operation will only save one copy of the TWS settings on the server. The serve does not store any backup copies.

 

How to download your TWS settings from the server:

On any computer (on which you want to use the same settings as above): Login with the Use/store settings on server option checked on the login window. This will download the settings, which you previously saved on our server.

 TWS Login Screen

 

Related articles

See KB3146 for instructions on how to overcome the "Downloading settings from server failed" error

See KB2323 for instructions on how to restore TWS settings from external storage

See KB2320 for instructions on transferring settings from one user to another

 

 

Syndicate content