Log in

J Allocation

The Allocation message provides the ability to specify how an order or set of orders should be subdivided amongst one or more accounts. It can also be used as a confirmation message through which third parties can communicate execution and settlement details between trading partners. In addition, the Allocation message can be sent by the broker to communicate fees and other details that can only be computed once the sub-account breakdowns are known.

Allocation is typically communicated Post-Trade (after fills have been received and processed). It can, however, also be communicated Pre-Trade (at the time the order is being placed) to specify the account(s) and their respective order quantities which make up the order. This is a regulatory requirement in certain markets and for certain types of securities.

An Allocation message can be submitted as preliminary, calculated, calculated without preliminary, new, cancel or replace. The AllocTransType (71) field indicates the purpose of the message. When submitting calculated, replace, or cancel AllocTransType (71) messages the RefAllocID (72) field is required. Note that AllocTransType (71) of Cancel, Reject, or Replace affects the entire Allocation message thus each AllocAccount (79) (cannot cancel, reject, or replace a single AllocAccount (79) instance without affecting the entire Allocation message). Replacement Allocation messages must contain all data for the replacement allocation. Calculated allocations should have a unique AllocID (70) and use RefAllocID (72) to specify the AllocID (70) from the preliminary. Calculated without preliminary are sent unsolicited from the sellside and do not require RefAllocID (72).

The Allocation message contains repeating fields for each order, sub-account and individual execution. The repeating fields shown below are marked with the =>symbol. The field's relative position in the message is important. For example, each instance of allocation must be in the order shown below.

  • The total shares allocated must equal the Shares (53) value which must equal the total executed quantity of the original order. If present, the total shares in the execution section must also be equal to this value.
  • The number of sub-account instances is indicated in NoAllocs (78).
  • Multiple orders can be combined for allocation by identifying the number of orders in the NoOrders (73) field and each individual order in the OrderID (37) fields. Combined orders must have the same ticker, trade date, settlement date and side.

Pre-Trade Allocation consists of the following steps:

Post-Trade Allocation can be computed via one of two methods:

  1. Using Average Price: Each AllocAccount (79) has a single AllocAvgPx (153)
  2. Using Executed Price: Combination of each AllocAccount (79) and AllocPrice (366) (unique LastPx (31)) (e.g. Japan)

Post-Trade Allocation supports three different message flows:

  1. Buyside initiated without Misc Fees
  2. Buyside-initiated with Misc Fee computation
  3. Sellside-initiated

See Appendix K: Example Usage of Allocations for more examples and details.

Note: Req'd = "Y*" indicates that the field is not required for AllocTransType (71) ='2' (Cancel)

Structure

TagNameTypeRequiredDescription
Component
Required
70String
Required
71Char Enum
Required
72StringRequired for AllocTransType = Calculated, Replace, or Cancel
196StringCan be used to link two different Allocation messages (each with unique AllocID) together, i.e. for F/X "Netting" or "Swaps"
197Int EnumCan be used to link two different Allocation messages and identifies the type of link. Required if AllocLinkID is specified
ComponentIndicates number of orders to be combined for allocation. If order(s) were manually delivered set to 1 (one)
ComponentIndicates number of individual execution repeating group entries to follow. Absence of this field indicates that no individual execution entries are included. Primarily used to support step-outs
54Char Enum
Required
55String
Required
65String
48String
22String Enum
167String EnumMust be specified if a Future or Option. If a Future: Symbol, SecurityType, and MaturityMonthYear are required. If an Option: Symbol, SecurityType, MaturityMonthYear, PutOrCall, and StrikePrice are required
200MonthYearSpecifies the month and year of maturity. Required if MaturityDay is specified
205DayOfMonthCan be used in conjunction with MaturityMonthYear to specify a particular maturity date
201Int EnumFor Options
202PriceFor Options
206CharFor Options
231FloatFor Fixed Income, Convertible Bonds, Derivatives, etc. Note: If used, quantities should be expressed in the "nominal" (e.g. contracts vs. shares) amount
223FloatFor Fixed Income
207ExchangeCan be used to identify the security
106String
348IntMust be set if EncodedIssuer field is specified and must immediately precede it
349DataEncoded (non-ASCII characters) representation of the Issuer field in the encoded format specified via the MessageEncoding field
107String
350IntMust be set if EncodedSecurityDesc field is specified and must immediately precede it
351DataEncoded (non-ASCII characters) representation of the SecurityDesc field in the encoded format specified via the MessageEncoding field
53Quantity
Required
Total number of shares allocated to all accounts
30ExchangeMarket of the executions
336String
6Price
Required
For F/X orders, should be the "all-in" rate (spot rate adjusted for forward points)
15CurrencyCurrency of AvgPx. Should be the currency of the local market or exchange where the trade was conducted
74IntAbsence of this field indicates that default precision arranged by the broker/institution is to be used
75LocalMktDate
Required
60UTCTimestampDate/time when allocation is generated
63Char EnumAbsence of this field is interpreted as Regular
64LocalMktDate"Settlement Date". Required with SettlmntTyp other than regular
381AmountExpressed in same currency as AvgPx. Sum of (AllocShares * AllocAvgPx or AllocPrice)
118AmountExpressed in same currency as AvgPx. Sum of AllocNetMoney
77Char Enum
58String
354IntMust be set if EncodedText field is specified and must immediately precede it
355DataEncoded (non-ASCII characters) representation of the Text field in the encoded format specified via the MessageEncoding field
157IntApplicable for Convertible Bonds and fixed income
158FloatApplicable for Convertible Bonds and fixed income
ComponentIndicates number of allocation groups to follow
Component
Required