Try TT Now

ICE Gateway

Configuring Account Management andLMA Support

Account Management Modes

ICE Gateways Version 7.3.7 and higher can support both System Managed Accounts (SMA) and Locally Managed Accounts (LMA), also known as Individual Trader Mnemonics (ITM) accounts.

Locally Managed Accounts (LMA) require account configuration with the ICE User Administration and specific customer setup in X_TRADER®.

Note

ICE does not support LMA configurations for OTC and CCX products.

For ICE Futures US, UK, and Canada, TT recommends configuring trader IDs to use either SMA or LMA. For OTC and CCX products, you must submit orders with an SMA account. The Exchange rejects orders submitted with an LMA account if the product is only available through SMA. You must use an SMA account for those products.

Note

For traders wishing to trade both US Futures and ICE UK Futures or ICE OTC products, both SMA and LMA accounts must be set up. Then, the appropriate account type can be selected via the Acct Type dropdown in the X_TRADER®Customer Default window.

For a complete list of products by market, refer to the Exchange’s Global Commodity Markets webpage at https://www.theice.com/products.jhtml.

In addition, Order Book sharing between LMA traders and SMA traders is not supported. The Exchange rejects orders when modified by a trader using a different account management mode.

The following terms and definitions relate to account management modes:

  • Clearing Firm ID: a numeric value created by ICE and assigned to the appropriate clearing firm. Some firms may consist of different regional entities with each assigned a unique ID.
  • NYBOT or WCE House Number: a numeric value, similar to the Clearing Firm ID but created by NYBOT or WCE and assigned to the appropriate clearing firm. Some firms may consist of different regional entities with each assigned a unique house number.
  • Clearing Account: a unique value requested by the trading company’s administrator and created by the clearing firm. The clearing firm sets limits and determines the tradable products for each account.

    The Clearing Account equals the value entered as Account in Guardian Risk for risk-managed traders. TTORD traders must have a unique value. Direct traders only require this value for SMA mode as required by ICE.

  • Customer Account Reference ID: a unique or shared back office ID generated by the trading company and/or clearing firm. This ID is created on the fly and contains a maximum of 12 characters. Firms can assign a unique ID to each trader, share an ID between multiple traders, or assign multiple IDs to a single trader.

    The customer account reference ID is optional for SMA and ICE Futures UK. ICE Futures US and ICE Futures Canada require a customer account reference ID for LMA.

Establishing a New Trader Account

The process for establishing a new trader account varies based on the account management mode:

  • System Managed Accounts: Requires account to be managed within the ICE System
    • The designated Responsible Individual requests ICE to generate a Trader ID for the new trader.
    • The Responsible Individual requests a new clearing account from the clearing firm through the ICE Credit Management GUI.
    • The Responsible Individual associates the trader to the new clearing account through the ICE Credit Management GUI.
  • Locally Managed Accounts: Removes the requirement to register each account number with ICE.
    • The designated Responsible Individual requests ICE to generate a Trader ID for the new trader.
    • The New Trader submits the ITM Request Form to the ICE Compliance Team.
    • The Clearing Firm may create and assign the clearing account to the new trader. However, this information is not maintained in the ICE Credit Management GUI.

FIX Tag Mapping

Note

Account Types are entered in X_TRADER®, but the mapping of Account Types to exchange Account Codes is configured in the hostinfo.cfg file on the ICE Gateway.

The following table provides an overview of the X_TRADER® fields for configuring the account management code and the related FIX tags sent to the Exchange.

FIX Tag Mapping for Account Management Modes
TT Customer Default Give Up Account # FFT2 Acct Type
ICE FIX Tag ClearingFirm Tag 439 ClearingAccountTag 440 CustAcctRefID Tag 9207 AccountCode Tag 9195CTI Code Tag 9208

SMA- ICE Futures (US, UK, Singapore, and Canada) ICE OTC CCX Futures

Liffe Futures (US and UK)

TT Required

TT Required

TT Optional

TT Required

ICE Required

ICE Required

ICE Optional

Not required by ICE

LMA- ICE Futures US

TT Required LMA + NYBOT House Number

TT Required (TTORDs)

TT Optional

TT Required

ICE Required (Only House number sent to ICE)

Not sent to ICE

ICE Required

ICE Required

LMA- ICE Futures Canada

TT Required LMA + WCE House Number

TT Required (TTORDs)

TT Optional

TT Required

ICE Required (Only House number sent to ICE)

Not sent to ICE

ICE Required

ICE Required

LMA- ICE Futures UK and Singapore, Liffe Futures UK

TT Required LMA

TT Required (TTORDs)

TT Optional

TT Required

Not sent to ICE

Not sent to ICE

ICE Required

Tag 9195 is ICE Required

Tag 9208 is not required by ICE

LMA- Liffe Futures US

TT Required LMA + House Number

TT Required (TTORDs)

TT Optional

TT Required

ICE Required (Only House number sent to ICE)

Not sent to ICE

ICE Required

ICE Required

Note

In all modes, ICE Gateways forward the value of FFT3, if present, to client applications and to the Exchange.

Configuring SMA

To submit orders in SMA mode, configure the following in the Customer Defaults window in X_TRADER®:

  • Account # equals the Clearing Account as requested by the trading firm’s administrator from the clearing firm. Required by TT and ICE and sent to the Exchange.
  • Give Up equals the numeric Clearing Firm ID as assigned by the Exchange. Required by TT and ICE and sent to the Exchange.
  • FFT2 can remain blank or optionally set FFT2 equal to the Customer Account Reference ID generated by the trading company and/or clearing firm. Optional for TT and ICE and only sent if present.
  • Acct Type equals any available value. Required only by TT. Only Account Code (9195) sent to the Exchange.

The following table lists the Audit Trail messages related to misconfiguration for all markets in SMA mode:

Audit Trail Message for SMA-All Markets
Message Cause

GS_clearingAccountNotFound

Account number is not associated with the trader or account number does not exist.

Invalid user configuration

Direct Trader enters an order that does not contain an Account number.

600 Bad integer value (ICE) in field type 439

Give Up field does not contain a valid value.

Configuring LMA for ICE Futures US and Canada

You must set up LMA functionality by creating or updating a user profile and trader ID with ICE’s User Administration.

Once a trader ID is set up for LMA with ICE, submit orders in LMA mode for ICE Futures US or ICE Futures Canada by configuring the following in the Customer Defaults window in X_TRADER®:

  • Account # equals the customer defined back office account. Required by TT only and never sent to the Exchange.
  • Give Up equals LMA plus the NYBOT or WCE House Number. Required by TT and ICE. Only the House Number is sent to the Exchange.

    For example, if the House Number equals 297, set Give Up equal to LMA297.

  • FFT2 equals the Customer Account Reference ID generated by the trading company and/or clearing firm. Required only by ICE and sent to the Exchange.
  • Acct Type equals one of the following: G1, G2, G3, M1, P1, P2, P3, or U1. Required by TT and ICE and sent to the Exchange.

The following table lists the Audit Trail messages related to misconfiguration for ICE Futures US and ICE Futures Canada in LMA mode:

Audit Trail Messages for LMA-ICE Futures US and ICE Futures Canada
Message Cause

FFT2 and valid Acct Type fields are required for Trading ICE Futures US/Canada in LMA Mode

FFT2 field does not contain a value

-or-

Entering an order when Acct Type contains a CTICode mapped to 0 (i.e., selecting A1, A2, A3, M2, M3, U2, U3, or none).

MR_invalidClearingInfo

Entering an order for a Canadian product with Customer Default set for ICE US Futures or vice versa.

0 Invalid tag 9207 value length. CustomerAccountRefId field value must be <= 12 characters

FFT2 field (Customer Account Ref ID) contains more than 12 characters.

Configuring LMA for ICE Futures UK

You must set up LMA functionality by creating or updating a user profile and trader ID with ICE’s User Administration.

Once a trader ID is setup for LMA with ICE, you can submit orders in LMA mode for ICE Futures UK by configuring the following in the Customer Defaults window in X_TRADER®:

  • Account # equals the customer defined back office account. Required by TT only and never sent to the Exchange.
  • Give Up equals LMA without any additional values. Required by TT only and never sent to the Exchange.
  • FFT2 can remain blank or you may optionally set FFT2 equal to the Customer Account Reference ID generated by the trading company and/or clearing firm. Optional for TT and ICE. Only sent to the Exchange if present.
  • Acct Type equals any available value. Required by TT. Only Account Code (9195) sent to the Exchange.

The following table lists the Audit Trail messages related to misconfiguration for ICE Futures UK in LMA mode:

Audit Trail Messages for LMA-ICE Futures UK
Message Cause

MR_invalidClearingInfo

Entering an order for product in a different market with the Customer Defaults set for LMA-ICE Futures US or Canada.

Bad integer value (ICE) in field type 439

Entering an order for an ICE Futures UK product but Give Up field not set to LMA.

Account Types

ICE Gateways support account type routing. You can specify the account type to apply to each order. This allows the ICE host to designate the type of funds and the way the funds can be used by the clearing firm.

You can set the account types in the Customer Defaults window of X_TRADER® and in the Market Grid’s Order Entry Pane. For information on setting account types, refer to the X_TRADER® User Manual. You can also set account types and CTI codes in the [OrderSession#] section of the hostinfo.cfg file. For more information on the hostinfo.cfg configuration, refer to Section: [OrderSession#].

For all System Managed Accounts and Locally Managed Accounts for ICE Futures UK, the ICE Gateway only forwards the Account Code (FIX Tag 9195); therefore, you can set the Acct Type field equal to any TT Account Type.

For Locally Managed Accounts for ICE Futures US and ICE Futures Canada, you can only select a value where the CTICode is greater than 0. For these products, you can only select G1, G2, G3, M1, P1, P2, P3, or U1.

The following table lists the TT Acct Type Fields, Account Code Mapping, CTICodes and corresponding ICE Account Types:

Account Types
TT Acct Type TRS Account Type Mapping (FIX Tag 9195) CTICode (FIX Tag 9208) ICE Account Type
A1

N

0

Non-segregated

A2

S

0

Segregated

A3

U

0

Unassigned

A4

U

0

Unassigned

A5

U

0

Unassigned

A6

U

0

Unassigned

A7

U

0

Unassigned

A8

U

0

Unassigned

A9

U

0

Unassigned

G1

C

1

Customer
G2

C

2

Customer
G3

C

3

Customer
M1 C

4

Customer

M2

U

0

Unassigned

M3

U

0

Unassigned

P1

H

1

House

P2

H

2

House

P3

H

3

House

U1

H

4

House

U2

U

0

Unassigned

U3

U

0

Unassigned

None

U

0

Unassigned

Note

You can select the TT Account Type to assign to orders. To use Account Types A4 - A9, X_TRADER® 7.9 is required.

Updated Account Codes

ICE has introduced new position and settlement/margin account codes for use in the custom Account Code field (FIX Tag 9195).

The new values for custom field Account Code Tag 9195 are as follows:

  • I = Individual Client Segregated (ISOC) - I
  • J = Individual Client Segregated (ISOC) - J
  • F = Currently unassigned
  • W = US Customer ICE OTC
  • Z = US Customer ICE Futures UK
  • Note

    Account code mapping is subject to be changed at any time by the Exchange. For the most updated information, please contact ICE.

Users may leverage these values by modifying their hostinfo.cfg file to assign the newly introduced ICE Account Codes (FIX Tag 9195) to any unused TT Account Type (i.e., A3, A4, A5, A6, A7, A8, A9, M2, M3, U2, and U3). Customers trading through X_TRADER Version 7.9 and higher may also assign these values to Account Types A4 - A9.

To use the new account codes, the following configuration changes must be applied to each [OrderSession#] in your hostinfo.cfg file.

To configure new account codes:

  1. In Windows Explorer, navigate to <rootdrive>:ttconfig
  2. Using a text editor (such as Notepad), open the hostinfo.cfg file.
  3. For each unique FIX connection that the ICE Gateway supports, modify the corresponding [OrderSession#] section by assigning the newly introduced ICE Account Codes to one of the following TT Account Types (i.e., A3, A4, A5, A6, A7, A8, A9, M2, M3, U2, and U3) via the AccountType parameter.
    Note

    To use Account Types A4 - A9, X_TRADER® Version 7.9 is required.

    The following example illustrates Account Code configuration:

    Example SMA and LMA Mode

    Customers using SMA or LMA accounts will need to assign one of the following TT Account Types (i.e., A3, A4, A5, A6, A7, A8, A9, M2, M3, U2, and U3) to the newly introduced ICE Account Codes, (i.e., I, J, F, W, and Z) in each [OrderSession#] section of the hostinfo.cfg file.

    When configuring the AccountType parameter in SMA or LMA mode, a valid configuration would be: AccountType=ICE Account Code,0

    For example, the M2, M3, A3, and A4 TT Account Types are assigned to ICE Account Codes and added to the [OrderSession1] and [OrderSession2] section:

    [OrderSession1]

    ExchangeIP=10.1.2.3

    ExchangePort=1001

    GatewayCompany=GMT

    ExchangeCompany=ICE

    GatewaySessionId=TGM

    SessionUserName=G3

    SessionPassword=password

    Member=ICE

    M2=W,0

    M3=Z,0

    [OrderSession2]

    ExchangeIP=10.1.2.3

    ExchangePort=1234

    GatewayCompany=56789

    ExchangeCompany=ICE

    GatewaySessionId=Trader1

    SessionUserName=G4

    SessionPassword=password

    Member=GFACB

    A3=W,0

    A4=Z,0

    In the Account Type field located in the X_TRADER®Customer Defaults window, US Traders will now select M2 or A3 (depending on the session to which you are connecting) to trade ICE OTC products and M3 or A4 (depending on the session to which you are connecting) to trade ICE Futures UK products.

  4. Save and close the hostinfo.cfg file.

Interpreting the Audit Trail

The following table summarizes the various Audit Trail messages associated with common account management issues:

Audit Trail Messages
Message Cause

SMA Mode for all markets

GS_clearingAccountNotFound

Entering an order for an SMA configured product when the Customer Defaults set for LMA mode.

Invalid user configuration

Direct Trader enters an order that does not contain an Account #.

600 Bad integer value (ICE) in field type 439

Give Up field does not contain a value.

LMA Mode for ICE Futures US and ICE Futures Canada

FFT2 and valid Acct Type fields are required for Trading ICE Futures US/Canada in LMA Mode

FFT2 field does not contain a value

-or-

entering an order when Acct Type contains a CTICode mapped to 0 (i.e., selecting A1, A2, A3, M2, M3, U2, U3, or none).

MR_invalidClearingInfo

Entering an order for a product in one market with Customer Default set for a different Exchange.

0 Invalid tag 9207 value length. CustomerAccountRefId field value must be <= 12 characters

FFT2 field (Customer Account Ref ID) contains more than 12 characters.

LMA Mode for ICE Futures UK

MR_invalidClearingInfo

Entering an order for product in a different market when the Customer Defaults are set for LMA-ICE Futures UK mode.

Bad integer value (ICE) in field type 439

Entering an order for an ICE Futures UK product but Give Up field not set to LMA.