Allocation (MsgType = J)

The allocation record is used to instruct a broker on how to allocate executed shares to sub-accounts. The allocation record can also be used as a confirmation message through which third parties can communicate execution and settlement instructions between trading partners.

An Allocation (J) message can be submitted as new, cancel or replace. The AllocTransType (71) field indicates the purpose of the message. When submitting replace or cancel AllocTransType (71) messages the RefAllocID (72) field is required. Replacement Allocation (J) messages must contain all data for the replacement allocation.

The allocation record contains repeating fields for each order, sub-account and individual execution. The relative position of the repeating fields is important in this record, i.e. each instance of allocation must be in the order shown below.

Tag Field Name FIXML Req'd Comments
<Standard Message Header> Y MsgType = J
70 AllocID Y
71 AllocTransType Y
72 RefAllocID C Required for AllocTransType (71) = R (Replace) or C (Cancel)
73 NoOrders Y Indicates number of orders to be combined for allocation. If order(s) were manually delivered set to 1 (one).
=> 11 ClOrdID Y Order ID assigned by client if order(s) were electronically delivered and executed. If order(s) were manually delivered this field should contain string 'MANUAL'.
=> 37 OrderID N
=> 66 ListID N Required for List Orders.
=> 105 WaveNo N
124 NoExecs C Indicates number of individual execution record groups to follow. Absence of this field indicates that no individual execution records are included.
=> 17 ExecID C Required if NoExecs (124) > 0
=> 32 LastShares C Number of shares in individual execution. Required if NoExecs (124) > 0
=> 31 LastPx C Price of individual execution. Required if NoExecs (124) > 0
=> 30 LastMkt N Market of individual execution.
54 Side Y
55 Symbol Y
65 SymbolSfx N
48 SecurityID N
22 IDSource N
106 Issuer N
107 SecurityDesc N
53 Shares Y Total number of shares allocated to all accounts
6 AvgPx Y
15 Currency N Currency of AvgPx (6) , absence of this field indicates US dollars
74 AvgPrxPrecision N Absence of this field indicates that default precision arranged by the broker/institution is to be used
75 TradeDate Y
60 TransactTime N Date/time when allocation is generated
63 SettlmntTyp N Absence of this field is interpreted as Regular
64 FutSettDate C Required with SettlmntTyp (63) other than regular
118 NetMoney N Expressed in same currency as AvgPx (6)
136 NoMiscFees N Required if any miscellaneous fees are reported. Indicates number of repeating entries
=> 137 MiscFeeAmt C Required if NoMiscFees (136) > 0
=> 138 MiscFeeCurr C Required if NoMiscFees (136) > 0
=> 139 MiscFeeType C Required if NoMiscFees (136) > 0
119 SettlCurrAmt N
120 SettlCurrency N
77 OpenClose N
58 Text N
78 NoAllocs Y Indicates number of allocation groups to follow.
=> 79 AllocAccount Y
=> 80 AllocShares Y
=> 81 ProcessCode N
=> 76 ExecBroker C Required for step-in and step-out trades
=> 109 ClientID N Used for firm identification in third-party transactions.
=> 12 Commission N
=> 13 CommType N
=> 85 NoDlvyInst N Repeating group within allocation group
=> => 92 BrokerOfCredit C
=> => 86 DlvyInst C Required if NoDlvyInst (85) > 0
<Standard Message Trailer> Y