The modifications below are in build 9.70 of the TWS API.

For clarification on any of the items listed, send us an email at API Support.
Enhancements
New API Requests and Callbacks

The following API requests and callbacks have been added:

API requests used to integrate with TWS color-grouped windows (display groups):

    queryDisplayGroups(int requestId)
    where
    requestId = The unique number that will be associated with the response
    subscribeToGroupEvents(int requestId, int groupId)
    where
    requestId = The unique number associated with the notification.
    groupId = The ID of the group, currently it is a number from 1 to 7.
    This is the display group subscription request sent by the API to TWS.
    updateDisplayGroup(int requestId, String contractInfo)
    where
    requestId = The requestId specified in subscribeToGroupEvents().
    contractInfo = The encoded value that uniquely represents the contract in IB. Possible values include:
        none = empty selection
        contractID@exchange – any non-combination contract. Examples: 8314@SMART for IBM SMART; 8314@ARCA for IBM @ARCA.
        combo = if any combo is selected.
    This request from the API does not get a response from TWS unless an error occurs.
    unsubscribeFromGroupEvents(int requestId)
    where
    requestId = The requestId specified in subscribeToGroupEvents().
    This request from the API does not get a response from TWS.

TWS color-grouped windows are identified by an integer number. Currently that number ranges from 1 to 7 and are mapped to specific colors, as indicated in TWS.

Callbacks used to integrate with TWS color-grouped windows:

    displayGroupList(int requestId, String groups)
    where
    requestId = The requestId specified in queryDisplayGroups().
    groups = A list of integers representing visible group ID separated by the “|” character, and sorted by most used
    group first. This list will not change during TWS session (in other words, user cannot add a new group; sorting can change though). Example: “3|1|2”
    This callback is a one-time response to queryDisplayGroups().
    displayGroupUpdated(int requestId, String contractInfo)
    where
    requestId = The requestId specified in subscribeToGroupEvents().
    contractInfo = The encoded value that uniquely represents the contract in IB. Possible values include:
        none = empty selection
        contractID@exchange – any non-combination contract. Examples: 8314@SMART for IBM SMART; 8314@ARCA for IBM @ARCA.
        combo = if any combo is selected.
    This is sent by TWS to the API client once after receiving the subscription request subscribeToGroupEvents(), and will be sent again if the selected contract in the subscribed display group has changed.


New Order Fields

The following attributes have been added to the Order socket client properties in the Java and C++ APIs and to the COM object in the ActiveX API:

    activeStartTime - String, used in GTC orders.
    activeStopTime - String, used in GTC orders.
    scaleTable - String, used for Scale orders.