How to add a user to an existing IB Key instance - iOS


This page covers the steps required to add a user to the Authentication section in the IBKR Mobile app for iOS devices.


  • The IBKR Mobile app must be installed and IB Key Authentication already activated on this iOS device.
  • For more information on the installation and activation on iOS devices, please refer to KB2278.



1. On your iOS device, open the IBKR Mobile app.

     1.a. If the app opens with the login screen (Figure 1), tap on Services on the top-left corner (red arrow) and proceed with step 2

     1.b. If the app opens with your Home Page, Portfolio, Watchlists, or similar , tap on More on the bottom-right corner (Figure 2). Then tap on Services on the top-left corner (Figure 3) and proceed with step 2.

Figure 1.                                       Figure 2.                                       Figure 3.


2. Tap on Authenticate (Figure 4) and then on Add User (Figure 5).

Figure 4.                                          Figure 5.


3. Read the instructions and then tap on Continue (Figure 6).

Figure 6.

4. Enter your Username and Password, and then tap on Continue (Figure 7)

Figure 7.

5. An Authentication Code will be sent via SMS to the mobile phone number listed on your account (Figure 8). Enter this Authentication Code in the Activation Code field and tap on Activate (Figure 9).

Figure 8.                                                    Figure 9.


6. Depending on your smartphone's security settings, you will be asked to use your Passcode, Touch ID, or Face ID (Figure 10.).

Figure 10.

7. If the activation has been successful, you will see a confirmation screen. Finally, tap on Done to complete the procedure (Figure 11).

Figure 11.

How to fix the "Cannot create ... file" error during TWS installation on MacOS


The filesystem permissions are controlled by your machines operating system. One of their functions is to secure your files, preventing unauthorized access or undesired modifications to the system and to your personal data.   

Some software on your computer may modify or override the permissions assigned by the operating system. Under certain circumstances, this prevents the TWS installer from accessing the folder where the application core files have to be created (/users/youruser/home/Applications). In such cases, the TWS installation usually displays the error "Cannot create ... file. Shall I try again?"

In this article we explain how to reset the filesystem permission of the "Applications" folder located under your user home folder in order to allow a smooth run of the TWS installation.


1. On your keyboard, press ⌘CMD + ⇧Shift +H to open your home folder
 Figure 1
2. Select the folder "Applications" within your home folder and press ⌘CMD + I to open the Info panel
 Figure 2
2. At the bottom right of the panel, click on the padlock
 Figure 3
3. To unlock the permissions panel, enter your MacOS credentials and click OK
 Figure 4
4. In the line correspondent to "everyone", click on "No Access" (Figure 5) and then select "Read & Write" (Figure 6)
 Figure 5                                                                            Figure 6
5. Click on the icon bellow the permissions panel and select “Apply to enclosed items..."
 Figure 7
6. Now run the TWS installer and click on Next> until you complete the installation
 Figure 8

7. Once the installation has completed successfully, repeat the previous steps from 1. to 5. setting back the permissions of “everyone” to “Read Only” to revert your changes to the initial status



How to log in to IBKR Mobile when the IB Key is enabled on another phone

This article is intended for clients who have activated the IBKR Mobile authentication on their smartphone and possess as well an additional mobile device, on which they desire to trade.
Clients with this setup will be able to log in to the IBKR Mobile trading platform on their secondary device, using their smartphone to complete the Two-Factor Authentication step.


For the purposes of this article, we will use the following naming convention:

Authentication device: this is the smartphone on which you activated the IBKR Mobile Authentication (IB Key)

Trading device: this is where you want to use IBKR Mobile app for trading.



Please click on one of the link below according to your phone operating system:


Apple iOS

1. On your Trading device, launch the IBKR Mobile app. Enter your your credentials in the login screen and tap Log In
 Figure 1
2. Tap Two-Factor Authentication (Figure 2).  A Challenge code will be displayed (Figure 3)
  Figure 2                                                            Figure 3
3. On the Authentication device, launch the IBKR Mobile app
 Figure 4
4a. If you are not automatically logged in, tap Services (Figure 5) on the top left, then tap Authenticate (Figure 6).
 Figure 5                                                          Figure 6
4b. If you are already logged in, tap on the More button on the bottom right. Then, scroll down and tap on Authenticate
  Figure 7

5. Enter the Challenge code you obtained at point 2. Then tap Generate Response (Figure 8). Once you have provided your security element (Figure 9), you will receive a Response String (Figure 10).
  Figure 8                                                     Figure 9                                                  Figure 10

6. On your Trading device, enter the Response String into the "Enter response code" field and tap Send to finalize the authentication process.
 Figure 11




1. On your Trading device, launch the IBKR Mobile app. Enter your your credentials in the login screen and tap Log In
  Figure 1
2. Tap on the option Two-Factor Authentication (Figure 2).  You will see a Challenge code (Figure 3)
 Figure 2                                                          Figure 3
3. On the Authentication device, launch the IBKR Mobile app
 Figure 4
4a. If you are not automatically logged in, tap Services (Figure 5) and then tap Authenticate (Figure 6).
 Figure 5                                                            Figure 6
4b. If you are already logged in, tap the Menu button (Figure 7), scroll down and tap Authenticate (Figure 8).
  Figure 7                                                          Figure 8
5. Enter your IBKR Mobile PIN and the Challenge code you obtained at point 2. Then tap Generate Response (Figure 9). A Response String will be displayed (Figure 10)
  Figure 9                                                         Figure 10
6. On your Trading device, enter the Response String in to the "Enter response code" field and then tap Log In to finalize the authentication process.
 Figure 11

  • See KB2260 for general instructions on how to use IBKR Mobile Authentication
  • See KB3073 for instructions on how to migrate the IB Key / IBKR Mobile authentication to a new smartphone
  • See KB2748 for instructions on how to perform the IB Key / IBKR Mobile authentication recovery


How do I enable the Notifications for the IBKR Mobile app


What is a notification?

A push notification is a brief message which is sent ("pushed") from a back-end server to your device over the Internet. Apps developers use those attention-grabbing messages to quickly and effectively reach the recipients, even if they are not currently engaging with their application. Notifications can deliver information to users or advise them of a specific action they are invited or required to perform.


Why does the IBKR Mobile app use notifications?

The IBKR Mobile application uses notifications for informational purposes, as well as two-factor authentication. In the latter case, the user is invited to tap on the notification, which will automatically open the IBKR Mobile app and begin the authentication process.

This procedure explains how to manually enable notifications for the IBKR Mobile app. Please click the link below that matches your smartphone's operating system.

Apple iOS

1. On your home screen, tap Settings (Figure 1), then Notifications (Figure 2) and finally IBKR (Figure 3)
 Figure 1                                                 Figure 2                                                   Figure 3                                 
2. In the IBKR app settings, you will see a number of different options. We recommend to set them in the following way (Figure 4):
  • Allow Notifications: enabled
  • Lock Screen, Notification Center, Banners: selected
  • Banner style: Persistent
  • Badges: enabled
  • Show Previews: Always
 Figure 4



1. Go the Settings of your phone, then tap Apps & notifications1 (Figure 1) then IBKR Mobile (Figure 2) and finally App notifications (Figure 3)
 Figure 1                                                    Figure 2                                                     Figure 3                           
2.  Ensure that notifications for this app are globally On and the switches Allow notification dots, Allow interruptions, On the lock screen are all enabled (Figure 4). According to your personal preference, you may want to enable as well the switch Override Do Not Disturb
 Figure 4

Please note that menu items labels and positions may vary according to your device vendor and software version.


1. The Apps & notifications item may be called Sound & notification on certain devices

  • See KB2260 for instruction on how to activate and operate IBKR Mobile Authentication
  • See KB3234 for troubleshooting missing IBKR Mobile notifications
  • See KB2748 for information about IBKR Mobile Authentication recovery


Fusión de IB TWS y IB Key en IBKR Mobile


La migración para su usuario depende del uso actual de las aplicaciones:

1. Su teléfono inteligente solo se utiliza para negociar (IB TWS instalada) - Haga clic aquí
2. Su teléfono inteligente solo se utiliza para autenticación (IB Key instalada) -  Haga clic aquí
3. Su teléfono inteligente se utiliza para negociación y autenticación (IB TWS y IB Key instaladas) - Haga clic aquí
4. Su teléfono inteligente se utiliza para transacciones de tarjeta de débito (IB Key instalada) -  Haga clic aquí

Usted es usuario de IB TWS

Ha negociado desde su teléfono inteligente con la IB TWS y no ha utilizado la IB Key.
1. Tras el primer uso de la aplicación, verá la siguiente pantalla de Inicio.
La Figura 1 es la pantalla de Inicio de IBKR Mobile para dispositivos iOS. La Figura 2 es la versión para dispositivos Android.

Figura 1                                                         Figura 2

2. Pulse en el botón Negociación (Trade).
3. El resto de la experiencia de la aplicación es idéntico a lo que ya ha utilizado en el pasado.


Acceso a las otras funciones desde la pantalla de negociación

Si desea acceder a las otras funciones de IBKR Mobile, como el módulo de Autenticación o
funciones de tarjeta de débito:

Para iOS (Figura 3)
1. Abra el menú ‘Más’ (esquina inferior derecha de la pantalla).
2. Baje al fondo de esta pantalla
Para Android (Figura 4)
1. Abra el menú de la aplicación
2. Baje a la sección inferior: ajustes de aplicación

Figura 3                                                                                                Figura 4

Usted es usuario de IB Key


1. Lance la IBKR Mobile y pulse en Autenticación.
2. La aplicación detectará la instalación de la IB Key y sugerirá un curso de acción; o bien una
migración automática (Figura 5) o bien una actualización y después una migración automática.
También puede elegir hacer la migración de forma manual en otro momento.

Figura 5                                                       Figura 6                                                    Figura 7

Una vez completada la migración, si ejecuta la aplicación IB Key independiente, con la que se ha
autenticado en el pasado, verá la siguiente pantalla (Figura 8).

 Figura 8


Operación diaria

A. Nada cambia en la experiencia diaria de conexión si usted tiene conexión a Internet - se utilizará
el proceso de autenticación ininterrumpida:
1. Introduzca sus credenciales en los campos correspondientes (en TWS, Gestión de Cuenta, WebTrader o
IBKR Mobile). Haga clic en Conexión (Login).
2. El sistema le enviará una notificación a la pantalla de su teléfono; púlsela.
3. Según su dispositivo, presente su cara a la cámara o la huella en el sensor (iOS) o
introduzca su código PIN (Android). El sistema procederá automáticamente con la conexión.

B. Si no tiene conexión a Internet, utilizará el IBKR Mobile en modo desafío-respuesta:
1. Introduzca sus credenciales en los campos correspondientes (en TWS, Gestión de Cuenta, WebTrader o
IBKR Mobile). Haga clic en ‘Conexión (Login)'.
2. Haga clic en el enlace que indica “No he recibido una notificación”.
3. Lance la IBKR Mobile y pulse en ‘Autenticación’.
4. En el campo Desafío de su aplicación del teléfono inteligente introduzca los valores que se muestren en la pantalla de Conexión. Pulse el botón ‘Generar’.
5. Introduzca los valores mostrados por su teléfono inteligente en el campo Cadena de respuesta en la Conexión. Haga clic en ‘Conexión’.


Usted es usuario tanto de la IB TWS como de la IB Key

1. Por favor, complete primero el procedimiento para la activación del módulo de Autenticación de la aplicación móvil IBKR (Haga clic aquí).
2. Conéctese a la pantalla de negociación pulsando en el botón Negociación (Trade) en la pantalla Inicio en su nueva aplicación móvil IBKR (Haga clic aquí).


Usted utiliza una tarjeta de débito IB

1. Por favor, complete primero el procedimiento para la activación del módulo de Autenticación de la aplicación móvil IBKR (Haga clic aquí).
2. En la pantalla de Inicio de la IBKR Mobile pulse en el botón Tarjeta de débito. El resto de la experiencia
es idéntico a lo que ya ha utilizado en el pasado.



Why is my chart delayed, showing question marks or only partially populated?

What  are SMART Charts and how are they generated?

The SMART charting mechanism analyzes and compares the market data coming from all venues a given contract is traded on and graphically displays the most favorable quotes.

When all the data streams are live, the data points are available for all sources and for each time point, thus they can be fully compared. The resulting SMART chart will be up to date and fully populated, moreover it will constantly and automatically update1.  

The comparison between non synchronized market data streams (some live and some delayed) is just partially possible, since the delayed feeds are lacking data points for the last 15 or 20 minutes. Therefore, within that time frame, the SMART chart will usually display a series of yellow question marks to indicate unavailability of source data. In this case the SMART Chart will not update automatically.

When the lack of data points is more extensive or when the Exchange does not distribute delayed data for a given contract, the correspondent SMART Chart may be completely blank.

What should I do to obtain a fully populated, up-to-date chart?

If your trading method is based on SMART charts, you would need to activate the live market data subscriptions for all the marketplaces your financial instruments are traded on. For additional details, please see KB1201

If your trading method does not require SMART charts, you can decide to use Direct chart routing as a workaround.

A Directed Chart will allow you to graphically represent the market data coming from a single, specific Exchange. When possible, we suggest to select the primary marketplace for the product for this purpose, since this is usually the one offering the highest liquidity and trade volume, hence normally providing the most favorable quotes. If you have subscribed the market data for that venue, the resulting Directed Chart will be fully populated, up to date and it will update automatically1.

How do I set up a Directed Chart?

1.  Within a watchlist, type the contract symbol and press Enter on your keyboard.

2.  When then contract selection menu appears, select the item Stock (Directed). If you do not see this item, click on the small down arrow at the bottom of the menu to reveal the hidden menu items.

3.  The Exchange selection screen will appear. You can now select the main Exchange for the product or the Exchange for which you have an active live market data subscription. Once done, click OK.

4.  Within your watchlist you will see a newly created Directed Ticker line. It will contain the contract symbol and, preceded by the @ sign, the Exchange you selected at the previous step. Right click on that directed ticker line and select Chart > New Chart


5. The chart will be shown. On the left side of the toolbar, after the contract symbol, you will see the Exchange you selected preceeded by a @ sign, indicating that this is a Directed Chart.

1. In order for the chart to update automatically, the checkbox "Keep chart up to date" has to be activated in the Chart Parameters panel. The panel is reachable directly within the chart window, from the top menu Edit.

Informes de cálculos de tarifa de exposición


Nuestro sistema de Gestión de Cuenta le permite configurar y gestionar su cuenta IB desde una sola ventana, incluido nuestro informe de cálculos de tarifas de exposición. Los cálculos de tarifa de exposición se generan diariamente y están disponibles dentro de Gestión de Cuenta antes de la apertura del mercado de acciones estadounidense. Este informe permite a los usuarios ver los cambios en las pérdidas y ganancias (PyG) de sus posiciones si el precio de cada una de sus posiciones aumenta o decrece según porcentajes predeterminados.



Para acceder/generar un informe de cálculos de tarifas de exposición

1) Desde la página de Inicio de Gestión de Cuenta, haga clic en las opciones de menú Informes y, luego, Otros informes.

2) La siguiente pantalla aparecerá.


3) Seleccione los Cálculos de tarifa de exposición desde el desplegable Tipo de informe. Aparecerán los ajustes de los cálculos de tarifa de exposición.


4) En el campo Fecha, seleccione la fecha para el informe
5) Haga clic para ejecutar informe



Los informes de resúmenes de tarifa de exposición reflejan la exposición promedio y la tarifa de exposición correspondiente para cada sector1 y un hiperenlace para ver nuestro informe de sensibilidad para la tarifa de exposición correlacionada.


Resumen de sector detallado

Al hacer clic en el hiperenlace asociado con cada sector1 se verá un resumen detallado, que permite a los usuarios ver el cambio en las PyG de sus posiciones si el precio del ETF/índice correspondiente aumenta/decrece según una cantidad determinada. Para el ejemplo de acciones e índices de acciones, suponemos que SPX baja en un 30%, 20% y 10% y el independiente aumenta un 10% y 20%. Los resultados están basados en modelos de precios teóricos y tienen en cuenta los cambios coincidentes en volatilidad y otras variables que afectan a los precios derivados.

El informe muestra: 

  • El valor de liquidación neto (NLV) de su cuenta, con base en posiciones del cierre del día previo. 
  • Exposición promedio para el sector 
  • Tarifa de exposición correspondiente
  • La liquidez de todas las posiciones en la cuenta con las PyG en la divisa base.

Para utilizar el informe, haga clic en el botón que corresponde con el cambio de precio de subida o bajada que usted quiere ver (+/- 10%, 20% o +30%). Las PyG de cada posición se actualizan según el porcentaje seleccionado.

Las siguientes figuras muestran un ejemplo de un resumen detallado del sector de la acción, con -30% seleccionado.

1 Las cuentas pueden tener una exposición promedio y una tarifa de exposición correspondiente para más de un sector.


Informe de sensibilidad para la tarifa de exposición correlacionada

Para cada contrato en la cartera, calculamos un estimado de la tarifa de exposición si la posición de un solo contrato se modifica. Suponemos que los contratos se compran o venden, no se transfieren. El cambio de posición no es editable y, en algunos casos, podría requerir que la cuenta cambiara la dirección de su posición, por ejemplo, de una posición corta a una posición larga. 


Para información adicional sobre la tarifa de exposición, consulte el artículo KB3114

Exposure Fee Calculation Reports


Our Account Management system lets you configure and manage your account from a single window, including our Exposure Fee Calculations report. The Exposure Fee Calculations is generated daily and made available within Account Management prior to the U.S. equity market open. This report allows users to view the change in Profit and Loss (PnL) of your positions if the price of each of your positions declines and increases by predetermined percentages.



To access/generate an Exposure Fee Calculations Report

1) From the Account Management Home Page, click on the Reports and then Other Reports menu options.

2) The following screen will appear.


3) Select Exposure Fee Calculations from the Report Type drop-down. Exposure Fee Calculations settings appear


4) In the Date field,select the date for the report
5) Click Run Report



The Exposure Fee Summary Reports reflects the Average Exposure and the corresponding Exposure Fee for each Sector1 and a hyper-link to view our Sensitivity Report for the Correlated Exposure Fee


Detailed Sector Summary

Clicking on the hyper-link associated with each sector1 will populate a detailed summary, which allows users to see the change in the PNL of your positions if the price of the corresponding ETF/Index increases / declines by a pre-determined amount. For the example of Equity Stocks and Indices we are assuming SPX declines by 30%, 20% and 10% and independent increases by 10% and 20% The results are based on theoretical pricing models and take into account coincidental changes in volatility and other variables that affect derivative prices

The report shows: 

  • The Net Liquidation Value (NLV) of your account based on positions from the previous day’s close 
  • Average Exposure for the sector 
  • Corresponding Exposure Fee
  • Equity of all positions in the account with PNL in base currency

To use the report, click the radio button that corresponds to the up or down price change you want to see (+/- 10%, 20% or +30%). The PNL for each position is updated by the selected percentage

The following are figure shows an example of a Detailed Summary of the Equity Sector, with -30% selected

1 Accounts may have Average Exposure and a corresponded Exposure Fee for more than 1 Sector


Sensitivity Report for the Correlated Exposure Fee

For every contract in the portfolio we compute an estimate of the exposure fee if the position of a single contract is modified. We assume that contracts are bought or sold, as opposed to transferred in/out. The position change is not editable and in some cases may actually require the account to reverse the direction of their position, for example from a short position to long position. 


For additional information regarding the Exposure Fee, please see KB3114

IB TWS and IB Key Merger into IBKR Mobile


The migration for your user depends upon your current use of the apps as follows:

1. Your Smartphone is solely used for trading (IB TWS installed) - Click Here
2. Your Smartphone is solely used for authentication (IB Key installed) -  Click Here
3. Your Smartphone is used for both trading and authentication (IB TWS and IB Key installed) - Click Here
4. Your Smartphone is used for Debit Card transactions (IB Key installed) -  Click Here

You are a user of IB TWS

You have been trading on your smartphone with IB TWS and you have not used IB Key.
1. Upon first launch of the application you will see the following new Home Screen.
Figure 1 is the Home Screen of IBKR Mobile for iOS devices. Figure 2 is the Android device version.

Figure 1                                                     Figure 2

2. Tap on the Trade button.
3. The rest of the application experience is identical to what you have already used in the past.


Access to the other functions from the Trading Screen

If you wish to access the other functions of the IBKR Mobile, such as the Authentication module or the
Debit Card functions:

For iOS (Figure 3)
1. Open the menu ‘More’ (lower right-hand corner of your screen).
2. Scroll to the very bottom of this page
For Android (Figure 4)
1. Open the Application menu
2. Scroll to the bottom section - App Settings


Figure 3


Figure 4

You are an IB Key user


1. Launch the IBKR Mobile and tap on Authentication.
2. The app will detect the installation of the IB Key and will suggest a course of action - either an
automated migration (Figure 5) on an update and then automated migration.
You can as well choose to manually migrate at a later point.

Figure 5                                                 Figure 6                                                 Figure 7

After the migration is completed, should you run the IB Key standalone application - the one you have
authenticated with in the past - you will see the following screen (Figure 8).

Figure 8


Daily Operation

A. Nothing changes in the daily login experience if you have an Internet connection - the Seamless
Authentication process will be used:
1. Enter your credentials in the corresponding fields (in the TWS, Account Management, WebTrader or
IBKR Mobile). Click on Login.
2. The system will send you a notification on your smartphone’s screen - tap on it.
3. Depending on your device, present your face to the camera or fingerprint on the sensor (iOS) or
enter your PIN code (Android). The system will the automatically proceed with the login.

B. If you have no Internet connection, you will use the IBKR Mobile in Challenge-Response mode:
1. Enter your credentials in the corresponding fields (in the TWS, Account Management, WebTrader or
IBKR Mobile). Click on ‘Login'.
2. Click on the link saying “I did not receive a notification”.
3. Launch the IBKR Mobile and tap on ‘Authentication’.
4. In the field Challenge of your smartphone application enter the values displayed on the Login
Screen. Tap the ‘Generate’ button.
5. Enter the values displayed by your smartphone app into the field Response string on the Login
Screen. Click ‘Login’.


You are a user of both IB TWS and IB Key

1. Please complete first the procedure for the activation of the Authentication module of the IBKR
Mobile app (Click Here).
2. Login to the trading screen by taping on the Trade button of the Home Screen in your new IBKR
Mobile app (Click Here).


You use an IB Debit Card

1. Please complete first the procedure for the activation of the Authentication module of the IBKR
Mobile app (Click Here).
2. On the Home Screen of the IBKR Mobile app tap on the Debit Card button. The rest of the experience
is identical to what you have already used in the past.



Cryptocurrency Products Offered by IBKR



  • GBTC (PINK)- Bitcoin Investment Trust


  • BITCOINXB (SFB)- Bitcoin Tracker One
  • COINETH (SFB)- XBT Provider Ethereum
  • COINETHE (SFB)- XBT Provider Ethereum


  • NYXBT (NYSE)- NYSE Bitcoin Index
  • GXBT (Cboe)- The Gemini Bitcoin Trace Price Index (No new contracts offered for trading as of June 2019)
  • BRR (CME)- CME Bitcoin Reference Rate Index
  • BRTI (CME)- CME Bitcoin Real Time Index


  • GXBT (Cboe/CFE)- The Gemini Bitcoin Trace Price Futures (No new contracts offered for trading as of June 2019)
  • BRR (CMECrypto)- CME Bitcoin Reference Rate Futures


Back to Table of Contents: Bitcoin and Other Cryptocurrency Products @ IBKR

Syndicate content