Tick Size Pilot ("TSP" or "Pilot") Program:

Under the TSP Program,  if IB receives any order in a Pilot Security that does not conform to the designated pricing increment (e.g., a limit price in a $0.01 increment for a security designated as trading $0.05 increments), IB will REJECT that order, subject to limited exceptions. IB strongly encourages a thorough review of your software or your vendor’s software to understand the criteria for what causes an order in a Pilot Security to be rejected to permit you or your vendor to make changes to correctly handle orders in Test Group Pilot Securities.
 

FREQUENTLY ASKED QUESTIONS:

Q: What is the Tick Size Pilot?
A: On May 6, 2015 the SEC approved an amended TSP NMS Plan. The Pilot will be two years in length. Data collection for the Pilot began on April 4, 2016, 6 months prior to the implementation of the trading and quoting rules for the Pilot. Implementation of the trading and quoting rules for the Pilot will begin on October 3, 2016.

The Pilot will be conducted using a Control Group and three Test Groups where variations in quoting and trading rules exist between each group. Please see the TSP NMS Plan for additional information.

Q: Will the Pilot quoting and trading rules apply during regular market hours, pre-market hours and post market hours?
A: The Pilot rules apply during all operational hours (pre-market, regular hours, and post market hours trading).

Q: Will the Pilot quoting and trading rules apply to odd-lot and mixed-lot sizes?
A: Yes, the Pilot rules to all order sizes.

Q: Will orders in Control Group Securities be accepted in price increments of less than $0.05?
A: Yes, orders submitted in price increments of less than $0.05 will continue to be accepted in Control Group securities.

Q: Will orders in a Test Group 1, 2 or 3 Pilot Securities be accepted in price increments of less than $0.05?
A: No, unless covered by an exception, orders submitted in price increments of less than $0.05 will be rejected.

Q: Which Pilot Security Orders in Test Groups will Interactive Brokers accept at other than $0.05 increments?
        Midpoint orders with no explicitly stated limit price or impermissible offsets will be accepted
        VWAP orders which do not have an explicitly stated limit price or impermissible offsets will be accepted.
        Interactive Brokers will accept Exchange operated Retail Price Improvement orders as follows:
                  Test Group 1 in $0.001 price increments
                  Test Groups 2 and 3 in $0.005 price increments.

Q: Will there be any changes to the Opening / Closing processes on Exchanges?
A: Please refer to each of the exchange rules for details but in general there will be no changes to the Opening / Closing process. All orders entered and eligible to participate in Exchange Opening / Closing Cross will be accepted in increments of $0.05. The Exchanges will begin publishing all quotes in increments of $0.05; however, Net Order Imbalance Indicator prices may be published in increments of $0.025.

Q: What will happen to my GTC order that was placed prior to October 3^rd in a Pilot Stock that was priced in impermissible tick increments?
A: Interactive Brokers will adjust outstanding limit and stop GTC orders in Pilot stocks in Test Groups that are not in permissible tick increments (e.g., a buy limit order at $5.01 will be adjusted to $5.00 and a sell limit at $5.01 adjusted to $5.05).

Q: What will happen to my GTC order placed after October 3^rd that was placed and accepted in a nickel tick increment but the Pilot Stock moves from a Test Group to the Control Group which permits non-nickel increments?
A: The GTC order will automatically be able to be revised by the user in non-nickel increments on the date the Pilot stock moves from the Test Group to the Control Group. Similarly, if a stock gets added to Test Group due to a corporate action, IB will cancel the GTC order if it is priced in impermissible increments.

Q: Where can I find out more information?

A: See KB2752 or the FINRA website for additional details regarding the Pilot Program: http://www.finra.org/industry/tick-size-pilot-program

NOTE: If you have already agreed to the API License Agreement please start at Step 3 below.

Instructions

1. Click directly on the button below to access the API software download page
   
2. This will direct you to Interactive Brokers API License Agreement, please review it
3. Once you have clicked "I Agree", refer to the Mac / Unix section to download the API Software version of your preference
   

4. This will download twsapi_macunix.n.m.zip to your computer
   (where n and m are the major and minor version numbers respectively)
5. Open Terminal (Ctrl+Alt+T on most distributions)
   (On Mac press Command+Space to launch Spotlight, then type terminal and press Return)
6. Navigate to the directory where the installer has been downloaded (normally it should be the Download folder within your home folder) and confirm the file is present

    $  cd ~/Downloads
    $  ls

7. Unzip the contents the installer into your home folder with the following command (if prompted, enter your password):
   $  sudo unzip twsapi_macunix.n.m.zip -d $HOME/
   
   
8. To access the sample and source files, navigate to the IBJts directory and confirm the subfolders samples and source are present
   $  cd ~/IBJts
   $  ls
   
   

Legacy Instructions - API Version ≤ 9.71

Note: IB only offers API Version 9.72+. In the event you already have an existing legacy version and need to install it, please refer to the directions below:

1. locate the file twsapi_macunix.n.m.jar on your computer
   (where n and m are the major and minor version numbers respectively.)
2. Open Terminal (Ctrl+Alt+T on most distributions)
   (On Mac press Command+Space to launch Spotlight, then type terminal and press Return)
3. Navigate to the directory where the .jar file has been located (normally it should be the Download folder within your home folder) and confirm it is present
   $  cd ~/Downloads
   $  ls
4. Extract the contents of the .jar file into your home folder
   $  jar xf twsapi_macunix.n.m.jar -d $ HOME/
5. To access the sample and source files, navigate to the IBJts directory and confirm the subfolders samples and source are present
   $  cd ~/IBJts
   $  ls

While MetaQuotes Software is not a participant of IBKR's Investors Marketplace, they offer to Introducing Brokers the oneZero Hub Gateway so that MetaTrader 5 can be used to trade IBKR Accounts^[1]. Clients interested would need to contact oneZero directly for additional assistance. Please refer to the Contact section from the following URL.

Note: Besides oneZero Hub Gateway, different vendors such as Trade-Commander, jTWSdata and PrimeXM also offer a software which they represent, acts as a bridge between MetaTrader 4/5 and the TWS. As is the case with other third-party software applications, IBKR is not in a position to provide information or recommendations as to the compatibility or operation of such software.

1: oneZero is not available for Individual Accounts, please click here for more information on Introducing Brokers.

Account holders are encouraged to routinely monitor their order submissions with the objective of optimizing efficiency and minimizing 'wasted' or non-executed orders.  As inefficient orders have the potential to consume a disproportionate amount of system resources. IB measures the effectiveness of client orders through the Order Efficiency Ratio (OER).  This ratio compares aggregate daily order activity relative to that portion of activity which results in an execution and is determined as follows:

OER = (Order Submissions + Order Revisions + Order Cancellations) / (Executed Orders + 1)

Outlined below is a list of considerations which can assist with optimizing (reducing) one's OER:

1. Cancellation of Day Orders - strategies which use 'Day' as the Time in Force setting and are restricted to Regular Trading Hours should not initiate order cancellations after 16:00 ET, but rather rely upon IB processes which automatically act to cancel such orders. While the client initiated cancellation request which serve to increase the OER, IB's cancellation will not.

2. Modification vs. Cancellation - logic which acts to cancel and subsequently replace orders should be substituted with logic which simply modifies the existing orders. This will serve to reduce the process from two order actions to a single order action, thereby improving the OER.

3. Conditional Orders - when utilizing strategies which involve the pricing of one product relative to another, consideration should be given to minimizing unnecessary price and quantity order modifications. As an example, an order modification based upon a price change should only be triggered if the prior price is no longer competitive and the new suggested price is competitive.

4. Meaningful Revisions – logic which serves to modify existing orders without substantially increasing the likelihood of the modified order interacting with the NBBO should be avoided. An example of this would be the modification of a buy order from $30.50 to $30.55 on a stock having a bid-ask of $31.25 - $31.26.

5. RTH Orders – logic which modifies orders set to execute solely during Regular Trading Hours based upon price changes taking place outside those hours should be optimized to only make such modifications during or just prior to the time at which the orders are activated.

6. Order Stacking - Any strategy that incorporates and transmits the stacking of orders on the same side of a particular underlying should minimize transmitting those that are not immediately marketable until the orders which have a greater likelihood of interacting with the NBBO have executed.

7. Use of IB Order Types - as the revision logic embedded within IB-supported order types is not considered an order action for the purposes of the OER, consideration should be given to using IB order types, whenever practical, as opposed to replicating such logic within the client order management logic. Logic which is commonly initiated by clients and whose behavior can be readily replicated by IB order types include: the dynamic management of orders expressed in terms of an options implied volatility (Volatility Orders), orders to set a stop price at a fixed amount relative to the market price (Trailing Stop Orders), and orders designed to automatically maintain a limit price relative to the NBBO (Pegged-to-Market Orders).

The above is not intended to be an exhaustive list of steps for optimizing one's orders but rather those which address the most frequently observed inefficiencies in client order management logic, are relatively simple to implement and which provide the opportunity for substantive and enduring improvements. For further information or questions, please contact the Customer Service Technical Assistance Center.