FIX.Latest_EP287 Message

AllocationInstruction [type 'J']

<AllocInstrctn>

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.

Pedigree Added FIX.2.7

Expand Components | Collapse Components

Field or ComponentField NameAbbr NameReq'dCommentsPedigree
ComponentStandardHeaderHdrYMsgType = JAdded FIX.2.7
70AllocIDIDYUnique identifier for this allocation instruction messageAdded FIX.2.7
2758AllocRequestIDReqID May be used to link to a previously submitted AllocationInstructionAlertRequest(35=DU) message.Added EP241
71AllocTransTypeTransTypYAdded FIX.2.7 Updated EP285
626AllocTypeTypYSpecifies the purpose or type of Allocation messageAdded FIX.4.3
793SecondaryAllocIDID2 Optional second identifier for this allocation instruction (need not be unique)Added FIX.4.4
72RefAllocIDRefID Required for AllocTransType = Replace or CancelAdded FIX.2.7
796AllocCancReplaceReasonCxlRplcRsn Required for AllocTransType = Replace or Cancel
Gives the reason for replacing or cancelling the allocation instruction
Added FIX.4.4
808AllocIntermedReqTypeImReqTyp Required if AllocType = 8 (Request to Intermediary)
Indicates status that is requested to be transmitted to counterparty by the intermediary (i.e. clearing house)
Added FIX.4.4
196AllocLinkIDLinkID Can be used to link two different Allocation messages (each with unique AllocID) together, i.e. for F/X Netting or SwapsAdded FIX.4.1
197AllocLinkTypeLinkTyp Can be used to link two different Allocation messages and identifies the type of link. Required if AllocLinkID is specified.Added FIX.4.1
1730AllocGroupIDGrpID Group identifier assigned by the clearinghouseAdded EP118
1728FirmGroupIDFirmGrpID Group identifier assigned by the firm.Added EP118 Updated EP282
466BookingRefIDBkngRefID Can be used with AllocType= Ready-To-Book Added FIX.4.3
857AllocNoOrdersTypeNoOrdsTyp 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.Added FIX.4.4 Updated EP118
ComponentOrdAllocGrpOrdAlloc Indicates number of orders to be combined for allocation. If order(s) were manually delivered set to 1 (one).Required when AllocNoOrdersType = 1Added FIX.4.4
ComponentExecAllocGrpAllExc 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.Added FIX.4.4 Updated EP118
570PreviouslyReportedPrevlyRpted Added FIX.4.4
700ReversalIndicatorReversalInd Added FIX.4.4
574MatchTypeMtchTyp Added FIX.4.4
54SideSideYAdded FIX.2.7
ComponentInstrumentInstrmtYInsert 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.
Added FIX.4.3 Updated EP82
ComponentInstrumentExtensionInstrmtExt Insert here the set of InstrumentExtension fields defined in Common Components of Application MessagesAdded FIX.4.4
ComponentFinancingDetailsFinDetls Insert here the set of FinancingDetails fields defined in Common Components of Application MessagesAdded FIX.4.4
ComponentUndInstrmtGrpUndly Added FIX.4.4
ComponentInstrmtLegGrpLeg Added FIX.4.4
53QuantityQtyYTotal quantity (e.g. number of shares) allocated to all accounts, or that is Ready-To-BookAdded FIX.2.7
854QtyTypeQtyTyp Added FIX.4.4
2974AllocGroupSubQtyIDGrpSubQtyID May be used as an alternative to attribute based subgrouping.Added EP285
30LastMktLastMkt Market of the executions.Added FIX.4.0
229TradeOriginationDateOrignDt Added FIX.4.3
336TradingSessionIDSesID Added FIX.4.2
625TradingSessionSubIDSesSub Added FIX.4.3
423PriceTypePxTyp Added FIX.4.3
ComponentPriceQualifierGrpPxQual Added EP230
6AvgPxAvgPx 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.
Added FIX.2.7 Updated EP82
860AvgParPxAvgParPx Added FIX.4.4
ComponentSpreadOrBenchmarkCurveDataSprdBnchmkCurve Insert here the set of SpreadOrBenchmarkCurveData fields defined in Common Components of Application MessagesAdded FIX.4.4
15CurrencyCcy Currency of AvgPx. Should be the currency of the local market or exchange where the trade was conducted.Added FIX.2.7
2897CurrencyCodeSourceCcySrc Added EP273
74AvgPxPrecisionAvgPxPrcsn Absence of this field indicates that default precision arranged by the broker/institution is to be usedAdded FIX.2.7
2795OffshoreIndicatorOffshrInd Added EP247
ComponentPartiesPty Insert here the set of Parties (firm identification) fields defined in Common Components of Application MessagesAdded FIX.4.3
75TradeDateTrdDtYAdded FIX.2.7
60TransactTimeTxnTm Date/time when allocation is generatedAdded FIX.2.7
63SettlTypeSettlTyp Added FIX.2.7
64SettlDateSettlDt Takes precedence over SettlType value and conditionally required/omitted for specific SettlType values.
Required for NDFs to specify the value date.
Added FIX.2.7 Updated EP82
775BookingTypeBkngTyp 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.Added FIX.4.4
381GrossTradeAmtGrossTrdAmt 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.Added FIX.4.2 Updated EP82
238ConcessionConcession Added FIX.4.3
237TotalTakedownTotTakedown Added FIX.4.3
118NetMoneyNetMny Expressed in same currency as AvgPx. Sum of AllocNetMoney.
For FX, if specified, expressed in terms of Currency(15).
Added FIX.4.0 Updated EP82
77PositionEffectPosEfct Added FIX.2.7
754AutoAcceptIndicatorAutoAcceptInd Indicates if Allocation has been automatically accepted on behalf of the Take-up Firm by the Clearing HouseAdded FIX.4.4 Updated EP118
58TextTxt Added FIX.2.7
354EncodedTextLenEncTxtLen Must be set if EncodedText field is specified and must immediately precede it.Added FIX.4.2
355EncodedTextEncTxt Encoded (non-ASCII characters) representation of the Text field in the encoded format specified via the MessageEncoding field.Added FIX.4.2
157NumDaysInterestNumDaysInt Applicable for Convertible Bonds and fixed incomeAdded FIX.4.1
158AccruedInterestRateAcrdIntRt Applicable for Convertible Bonds and fixed incomeAdded FIX.4.1
159AccruedInterestAmtAcrdIntAmt Applicable for Convertible Bonds and fixed incomeAdded FIX.4.1 Updated EP95
540TotalAccruedInterestAmtTotAcrdIntAmt Added FIX.4.3 Deprecated FIX.4.4
738InterestAtMaturityIntAtMat Added FIX.4.4
920EndAccruedInterestAmtEndAcrdIntAmt For repurchase agreements the accrued interest on termination.Added FIX.4.4
921StartCashStartCsh For repurchase agreements the start (dirty) cash considerationAdded FIX.4.4
922EndCashEndCsh For repurchase agreements the end (dirty) cash considerationAdded FIX.4.4
650LegalConfirmLegalCnfm Added FIX.4.3
ComponentStipulationsStip Added FIX.4.4
ComponentYieldDataYield Added FIX.4.4
ComponentRegulatoryTradeIDGrpRegTrdID Added EP179
ComponentPositionAmountDataAmt Insert here here the set of Position Amount Data fields defined in Common Components of Application MessagesAdded EP-1
892TotNoAllocsTotNoAllocs 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.
Added FIX.4.4
893LastFragmentLastFragment Indicates whether this is the last fragment in a sequence of message fragments. Only required where message has been fragmented.Added FIX.4.4
ComponentAllocGrpAlloc Conditionally required except when AllocTransType = Cancel, or when AllocType = Ready-to-book or Warehouse instructionAdded FIX.4.4
819AvgPxIndicatorAvgPxInd Indicates if an allocation is to be average priced. Is also used to indicate if average price allocation group is complete or incomplete.Added EP-1
1731AvgPxGroupIDAvgPxGrpID Firm designated group identifier for average pricingAdded EP118
715ClearingBusinessDateBizDt Indicates Clearing Business Date for which transaction will be settled.Added EP-1
828TrdTypeTrdTyp Indicates trade type of allocation. May be used as an alternative to AllocGroupSubQtyID(2974) for subgrouping.Added EP-1 Updated EP285
829TrdSubTypeTrdSubTyp Indicates trade subtype of allocation.Added EP-1 Updated EP285
855SecondaryTrdTypeTrdTyp2 Added EP237
2896TertiaryTrdTypeTrdTyp3 Added EP285
1390TradePublishIndicatorTrdPubInd May be used as an alternative to AllocGroupSubQtyID(2974) for subgrouping.Added EP285
1031CustOrderHandlingInstCustOrdHdlInst May be used as an alternative to AllocGroupSubQtyID(2974) for subgrouping.Added EP285
1937TradeContinuationTrdContntn Added EP237
2374TradeContinuationTextTrdContntnTxt Added EP258
2372EncodedTradeContinuationTextLenEncTrdContntnTextLen Must be set if EncodedTradeContinuationText(2371) field is specified and must immediately precede it.Added EP258
2371EncodedTradeContinuationTextEncTrdContntnText Encoded (non-ASCII characters) representation of the TradeContinuationText(2374) field in the encoded format specified via the MessageEncoding(347) field.Added EP258
582CustOrderCapacityCustCpcty Indicates CTI of original trade marked for allocation.Added EP-1
578TradeInputSourceInptSrc Indicates input source of original trade marked for allocation.Added EP-1
442MultiLegReportingTypeMLegRptTyp Indicates MultiLegReportType of original trade marked for allocation.Added EP-1
1011MessageEventSourceMsgEvtSrc Used to identify the event or source which gave rise to a message.Added EP-1
991RndPxRndPx Specifies the rounded price to quoted precision.Added EP-1
ComponentRateSourceRtSrc Added EP82
1430VenueTypeVenuTyp 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.Added EP192
2334RefRiskLimitCheckIDRefRiskLmtChkID Conditionally required when RefRiskLimitCheckIDType(2335) is specified.Added EP180 Updated EP192
2335RefRiskLimitCheckIDTypeRefRiskLmtChkIDTyp Conditionally required when RefRiskLimitCheckID(2334) is specified.Added EP180 Updated EP192
2343RiskLimitCheckStatusRiskLmtChkStat Added EP192
ComponentStandardTrailerTrlrYAdded FIX.2.7