Message AllocationInstruction (J)

The Allocation Instruction message provides the ability to specify how an order or set of orders should be subdivided amongst one or more accounts. In versions of FIX prior to version 4.4, this same message was known as the Allocation message. Note in versions of FIX prior to version 4.4, the allocation message was also used to communicate fee and expense details from the Sellside to the Buyside. This role has now been removed from the Allocation Instruction and is now performed by the new (to version 4.4) Allocation Report and Confirmation messages.,The Allocation Report message should be used for the Sell-side Initiated Allocation role as defined in previous versions of the protocol.

Added in protocol FIX.2.7

See in: FIX.4.0, FIX.4.1, FIX.4.2, FIX.4.3, FIX.4.4, FIX.5.0, FIX.5.0SP1, FIX.5.0SP2.

Field or Component Name Description Is Required Added Is Deprecated
Block StandardHeader MsgType = J Y FIX.2.7
70 AllocID Unique identifier for this allocation instruction message Y FIX.2.7
71 AllocTransType i.e. New, Cancel, Replace Y FIX.2.7
626 AllocType Specifies the purpose or type of Allocation message Y FIX.4.3
793 SecondaryAllocID Optional second identifier for this allocation instruction (need not be unique) FIX.4.4
72 RefAllocID Required for AllocTransType = Replace or Cancel FIX.2.7
796 AllocCancReplaceReason Required for AllocTransType = Replace or Cancel Gives the reason for replacing or cancelling the allocation instruction FIX.4.4
808 AllocIntermedReqType Required if AllocType = 8 (Request to Intermediary) Indicates status that is requested to be transmitted to counterparty by the intermediary (i.e. clearing house) FIX.4.4
196 AllocLinkID Can be used to link two different Allocation messages (each with unique AllocID) together, i.e. for F/X "Netting" or "Swaps" FIX.4.1
197 AllocLinkType Can be used to link two different Allocation messages and identifies the type of link. Required if AllocLinkID is specified. FIX.4.1
1730 AllocGroupID Group identifier assigned by the clearinghouse FIX.5.0SP2 (118)
1728 FirmGroupID Firm assigned entity identifier for the allocation FIX.5.0SP2 (118)
466 BookingRefID Can be used with AllocType=" Ready-To-Book " FIX.4.3
857 AllocNoOrdersType Indicates how the orders being booked and allocated by an AllocationInstruction or AllocationReport message are identified, e.g. by explicit definition in the OrdAllocGrp or ExecAllocGrp components, or not identified explicitly. FIX.4.4
ImplicitBlockRepeating OrdAllocGrp Indicates number of orders to be combined for allocation. If order(s) were manually delivered set to 1 (one).Required when AllocNoOrdersType = 1 FIX.4.4
ImplicitBlockRepeating ExecAllocGrp Indicates number of individual execution or trade entries. Absence indicates that no individual execution or trade entries are included. Primarily used to support step-outs. FIX.4.4
570 PreviouslyReported FIX.4.4
700 ReversalIndicator FIX.4.4
574 MatchType FIX.4.4
54 Side Y FIX.2.7
Block Instrument Insert here the set of "Instrument" (symbology) fields defined in "Common Components of Application Messages". For NDFs fixing date and time can be optionally specified using MaturityDate and MaturityTime. Y FIX.4.3
Block InstrumentExtension Insert here the set of "InstrumentExtension" fields defined in "Common Components of Application Messages" FIX.4.4
Block FinancingDetails Insert here the set of "FinancingDetails" fields defined in "Common Components of Application Messages" FIX.4.4
BlockRepeating UndInstrmtGrp FIX.4.4
BlockRepeating InstrmtLegGrp FIX.4.4
53 Quantity Total quantity (e.g. number of shares) allocated to all accounts, or that is Ready-To-Book Y FIX.2.7
854 QtyType FIX.4.4
30 LastMkt Market of the executions. FIX.4.0
229 TradeOriginationDate FIX.4.3
336 TradingSessionID FIX.4.2
625 TradingSessionSubID FIX.4.3
423 PriceType FIX.4.3
BlockRepeating PriceQualifierGrp FIX.5.0SP2 (230)
6 AvgPx For FX orders, should be the "all-in" rate (spot rate adjusted for forward points), expressed in terms of Currency (15). For 3rd party allocations used to convey either basic price or averaged price Optional for average price allocations in the listed derivatives markets where the central counterparty calculates and manages average price across an allocation group. FIX.2.7
860 AvgParPx FIX.4.4
Block SpreadOrBenchmarkCurveData Insert here the set of "SpreadOrBenchmarkCurveData" fields defined in "Common Components of Application Messages" FIX.4.4
15 Currency Currency of AvgPx. Should be the currency of the local market or exchange where the trade was conducted. FIX.2.7
74 AvgPxPrecision Absence of this field indicates that default precision arranged by the broker/institution is to be used FIX.2.7
BlockRepeating Parties Insert here the set of "Parties" (firm identification) fields defined in "Common Components of Application Messages" FIX.4.3
75 TradeDate Y FIX.2.7
60 TransactTime Date/time when allocation is generated FIX.2.7
63 SettlType FIX.2.7
64 SettlDate Takes precedence over SettlType value and conditionally required/omitted for specific SettlType values. Required for NDFs to specify the "value date". FIX.2.7
775 BookingType Method for booking. Used to provide notification that this is to be booked out as an OTC derivative (e.g. CFD or similar). Absence of this field implies regular booking. FIX.4.4
381 GrossTradeAmt Expressed in same currency as AvgPx (6). (Quantity (53) * AvgPx (6) or AvgParPx (860)) or sum of (AllocQty (80) * AllocAvgPx (153) or AllocPrice (366)). For Fixed Income, AvgParPx (860) is used when AvgPx (6) is not expressed as "percent of par" price. FIX.4.2
238 Concession FIX.4.3
237 TotalTakedown FIX.4.3
118 NetMoney Expressed in same currency as AvgPx. Sum of AllocNetMoney. For FX, if specified, expressed in terms of Currency (15). FIX.4.0
77 PositionEffect FIX.2.7
754 AutoAcceptIndicator Indicates if Allocation has been automatically accepted on behalf of the Take-up Firm by the Clearing House FIX.4.4
58 Text FIX.2.7
354 EncodedTextLen Must be set if EncodedText (355) field is specified and must immediately precede it. FIX.4.2
355 EncodedText Encoded (non-ASCII characters) representation of the Text (58) field in the encoded format specified via the MessageEncoding (347) field. FIX.4.2
157 NumDaysInterest Applicable for Convertible Bonds and fixed income FIX.4.1
158 AccruedInterestRate Applicable for Convertible Bonds and fixed income FIX.4.1
159 AccruedInterestAmt Applicable for Convertible Bonds and fixed income FIX.4.1
540 TotalAccruedInterestAmt FIX.4.3 Y
738 InterestAtMaturity FIX.4.4
920 EndAccruedInterestAmt For repurchase agreements the accrued interest on termination. FIX.4.4
921 StartCash For repurchase agreements the start (dirty) cash consideration FIX.4.4
922 EndCash For repurchase agreements the end (dirty) cash consideration FIX.4.4
650 LegalConfirm FIX.4.3
BlockRepeating Stipulations FIX.4.4
Block YieldData FIX.4.4
BlockRepeating RegulatoryTradeIDGrp FIX.5.0SP2 (179)
BlockRepeating PositionAmountData Insert here here the set of "Position Amount Data" fields defined in "Common Components of Application Messages" FIX.4.4
892 TotNoAllocs Indicates total number of allocation groups (used to support fragmentation). Must equal the sum of all NoAllocs values across all message fragments making up this allocation instruction. Only required where message has been fragmented. FIX.4.4
893 LastFragment Indicates whether this is the last fragment in a sequence of message fragments. Only required where message has been fragmented. FIX.4.4
ImplicitBlockRepeating AllocGrp Conditionally required except when AllocTransType = Cancel, or when AllocType = "Ready-to-book" or "Warehouse instruction" FIX.4.4
819 AvgPxIndicator Indicates if an allocation is to be average priced. Is also used to indicate if average price allocation group is complete or incomplete. FIX.4.4
1731 AvgPxGroupID Firm designated group identifier for average pricing FIX.5.0SP2 (118)
715 ClearingBusinessDate Indicates Clearing Business Date for which transaction will be settled. FIX.4.4
828 TrdType Indicates Trade Type of Allocation. FIX.4.4
829 TrdSubType Indicates TradeSubType of Allocation. Necessary for defining groups. FIX.4.4
855 SecondaryTrdType FIX.5.0SP2 (237)
1937 TradeContinuation FIX.5.0SP2 (237)
582 CustOrderCapacity Indicates CTI of original trade marked for allocation. FIX.4.4
578 TradeInputSource Indicates input source of original trade marked for allocation. FIX.4.4
442 MultiLegReportingType Indicates MultiLegReportType of original trade marked for allocation. FIX.4.4
1011 MessageEventSource Used to identify the event or source which gave rise to a message. FIX.4.4
991 RndPx Specifies the rounded price to quoted precision. FIX.4.4
BlockRepeating RateSource FIX.5.0SP1 (82)
1430 VenueType Used to identify on what kind of venue the trade originated when communicating with a party that may not have access to all trade details, e.g. a clearing organization. FIX.5.0SP2 (192)
2334 RefRiskLimitCheckID Conditionally required when RefRiskLimitCheckIDType (2335) is specified. FIX.5.0SP2 (180)
2335 RefRiskLimitCheckIDType Conditionally required when RefRiskLimitCheckID (2334) is specified. FIX.5.0SP2 (180)
2343 RiskLimitCheckStatus FIX.5.0SP2 (192)
Block StandardTrailer Y FIX.2.7