API Beta Notes

The modifications below are in build 9.63 of the TWS API. Please note that all the enhancements for release 9.63 require the minimum server version 45 (TWS version 896).

For clarification on any of the items listed, refer to the appropriate section in the API Reference Guide, or send us an email at Beta Support.
Enhancements
New HALTED Tick Type

When trading is halted for a contract, TWS receives a special tick: haltedLast=1. When trading is resumed, TWS receives haltedLast=0. A new tick type, HALTED, tick ID = 49, is now available in regular market data via the API to indicate this halted state.

Possible values for this new tick type are:

    * 0 = Not halted
    * 1 = Halted.

This enhancement applies to the ActiveX, C++ and Java APIs.
Support for Security Identifiers in the Contract Object

The following fields have been added to the Contract structure:

  String secIdType; // CUSIP;SEDOL;ISIN;RIC

  String secId; 

Use these fields when querying contract details (reqContractDetails) or when placing orders (placeOrder).

secIdType supports the following identifiers:

    * ISIN - The International Securities Identification Number (ISIN) that uniquely identifies the security but not the location at which it is traded. Example: Apple: US0378331005.
    * CUSIP - The nine-character Committee on Uniform Securities Identification Procedure (CUSIP) identifier for North American securities. Example: Apple: 037833100.
    * SEDOL - The Stock Exchange Daily Official List (SEDOL) identifier consisting of 6-AN + check digit. Example: BAE: 0263494.
    * RIC - The Reuters instrument code, consisting of the RIC Root (exchange-independent) and a suffix identifying the exchange at which the contract trades. RIC Root is unique for each company. Example: AAPL.O for Apple on NASDAQ.

Notes: If the CUSIP is defined, then ISIP = [US/CA][CUSIP][check digit]. The ISIN and CUSIP can replace the underlying, but when a contract trades in several locations (regions), you must also provide the primary exchange.

This enhancement applies to the ActiveX, C++ and Java APIs.
Fields added to the Contract Description Object

The following fields have been added to the Contract Description object:

    * String  contractMonth
    * String  industry
    * String  category
    * String  subcategory
    * String  timeZoneId
    * String  tradingHours
    * String  liquidHours

Examples:

contractMonth=200906
industry=Financial
category=Investment Svc
subcategory=Brokerage
timeZonId=EST
tradingHours=20090507:0700-1830,1830-2330;20090508:CLOSED
liquidHours=20090507:0930-1600;20090508:CLOSED

This enhancement applies to the ActiveX, C++ and Java APIs.
Important Bug Fixes
ActiveX for Excel

    * Fixed a typographical error in Util.FindOrderID.
    * Fixed the blinking on the Tickers page.
    * The localSymbol column has been added to all relevant pages.

DDE for Excel

    * Partial fills are now processed correctly.
    * Fixed TWS crashes that were due to a memory leak in a dde.dll.