API Build 9.69 - Release Notes
New Java API Sample Client
Beginning in this release, there is a new Java API Sample Client available. The new sample client has been completely rewritten and features many usability enhancements, including a tabbed interface, shown below. This new demo can be found in the API beta installation directory TWS API\samples\Java.
New Methods for Advisors
New methods and their associated events have been added to the ActiveX, Java, and C++ APIs to allow advisors to request data from the Account Window Summary tab and to request positions for all accounts. These methods and events require minimum server version 67 and minimum TWS version 936.
The new methods are:
- reqAccountSummary() - Requests the data that appears on the TWS Account Window Summary tab and keeps it up to date.
- cancelAccountSummary() - Cancels the request for Account Window Summary tab data.
- reqPositions() - Requests position data for all accounts.
- cancelPositions() - Cancels real-time position updates.
Their associated events are:
- accountSummary() - Returns the data from the TWS Account Window Summary tab.
- accountSummaryEnd() - This is called once all Summary tab data for a given request are received and functions as an end marker for the accountSummary() data.
- position() - Returns real-time positions for all accounts.
- positionEnd() - This is called once all position data for a given request are received and functions as an end marker for the position() data.
For complete details on the parameters for these methods and events, see the API Reference Guide.
Support for Mini Options Added to Active X, Java and C++ APIs
Support for mini options has been added to the Active X, Java and C++ APIs. You now can identify such products by providing the multiplier or trading class in both requests to TWS and responses from TWS. This enhancement requires minimum server version 68.
Specifically, the tradingClass string attribute has been added to the Contract structure and removed from the ContractDetails structure in order to support mini options requested by the API. The following requests and callbacks that include the Contract structure as a parameter can now handle the tradingClass and multiplier attributes for mini options. Also, some of these requests can now use the conId attribute to identify a security (these are indicated below).
Requests
- reqMktData
- reqHistoricalData - also conId
- reqRealTimeBars - also conId
- reqContractDetails
- reqMktDepth - also conId
- exerciseOptions - also conId
- placeOrder
- calculateImpliedVolatility
- calculateOptionPrice
Callbacks
- openOrder
- updatePortfolio
- execDetails
- position
Note the following:
- multiplier is encoded/decoded after contract.right and before contract.exchange in all requests and callbacks.
- conId is encoded after tickerId/reqId before contract.symbol in all requests and callbacks.
- tradingClass is encoded/decoded after contract.localSymbol in all requests and callbacks.
The reqFundamentalData request, available for stocks only, can also handle the conid attribute in the Contract structure but not tradingClass or multiplier.
Support for Mini Options Added to DDE for Excel API
Support for mini options has been added to the DDE for Excel API. You now can identify such products by providing the multiplier or trading class in both requests to TWS and responses from TWS. This enhancement requires minimum server version 68.
This release includes an updated version of the DDE for Excel API spreadsheet, TwsDde.xls, and an updated version (Version 16) of the file ddedll.dll. The updated spreadsheet now includes the Trading Class column on most pages. You use this field to request mini options data from TWS.
Requirements
Mini-option support requires the following:
- The updated Excel spreadsheet requires ddedll.dll Version 16 and TWS Version 9.69 or higher.
- Previous versions of the Excel spreadsheet will not work with ddedll.dll Version 16 and TWS Version 9.69 or higher.
- However, TWS Version 9.69 or higher will work with previous versions of the Excel spreadsheet if you are using a previous version of the ddedll.dll file.
For DDE syntax examples of mini options data requests, see the API Reference Guide.