Allocation

← Advertisement→ AllocationInstructionAck
MsgTypeJ
CategoryAllocation
SectionPostTrade
AddedFIX.2.7
Fields111
Components2
The Allocation message provides the ability to specify how an order or set of orders should be subdivided amongst one or more accounts.

Message Structure

111 fields, 2 components/groups — click any tag or field name for details
TagNameTypeReq DescriptionAdded
StandardHeader [Component]YMsgType = JFIX.2.7
8BeginStringStringYFIX.4.2 (Always unencrypted, must be first field in message)FIX.4.0
9BodyLengthintY(Always unencrypted, must be second field in message)FIX.4.0
35MsgTypeStringY(Always unencrypted, must be third field in message)
46 enum values
ValueNameDescription
0HeartbeatHeartbeat
1TestRequestTest Request
2ResendRequestResend Request
3RejectReject
4SequenceResetSequence Reset
5LogoutLogout
6IOIIndication of Interest
7AdvertisementAdvertisement
8ExecutionReportExecution Report
9OrderCancelRejectOrder Cancel Reject
aQuoteStatusRequestQuote Status Request
ALogonLogon
BNewsNews
bMassQuoteAcknowledgementQuote Acknowledgement
CEmailEmail
cSecurityDefinitionRequestSecurity Definition Request
DNewOrderSingleOrder Single
dSecurityDefinitionSecurity Definition
ENewOrderListOrder List
eSecurityStatusRequestSecurity Status Request
fSecurityStatusSecurity Status
FOrderCancelRequestOrder Cancel Request
GOrderCancelReplaceRequestOrder Cancel/Replace Request
gTradingSessionStatusRequestTrading Session Status Request
HOrderStatusRequestOrder Status Request
hTradingSessionStatusTrading Session Status
iMassQuoteMass Quote
jBusinessMessageRejectBusiness Message Reject
JAllocationInstructionAllocation
KListCancelRequestList Cancel Request
kBidRequestBid Request
lBidResponseBid Response (lowercase L)
LListExecuteList Execute
mListStrikePriceList Strike Price
MListStatusRequestList Status Request
NListStatusList Status
PAllocationInstructionAckAllocation ACK
QDontKnowTradeDont Know Trade (DK)
RQuoteRequestQuote Request
SQuoteQuote
TSettlementInstructionsSettlement Instructions
VMarketDataRequestMarket Data Request
WMarketDataSnapshotFullRefreshMarket Data-Snapshot/Full Refresh
XMarketDataIncrementalRefreshMarket Data-Incremental Refresh
YMarketDataRequestRejectMarket Data Request Reject
ZQuoteCancelQuote Cancel
FIX.4.0
49SenderCompIDStringY(Always unencrypted)FIX.4.0
56TargetCompIDStringY(Always unencrypted)FIX.4.0
115OnBehalfOfCompIDStringNTrading partner company ID used when sending messages via a third party (Can be embedded within encrypted data section.)FIX.4.0
128DeliverToCompIDStringNTrading partner company ID used when sending messages via a third party (Can be embedded within encrypted data section.)FIX.4.0
90SecureDataLenLengthNRequired to identify length of encrypted section of message. (Always unencrypted)FIX.4.0
91SecureDatadataNRequired when message body is encrypted. Always immediately follows SecureDataLen field.FIX.4.0
34MsgSeqNumintY(Can be embedded within encrypted data section.)FIX.4.0
50SenderSubIDStringN(Can be embedded within encrypted data section.)FIX.4.0
142SenderLocationIDStringNSender's LocationID (i.e. geographic location and/or desk) (Can be embedded within encrypted data section.)FIX.4.1
57TargetSubIDStringN"ADMIN" reserved for administrative messages not intended for a specific user. (Can be embedded within encrypted data section.)FIX.4.0
143TargetLocationIDStringNTrading partner LocationID (i.e. geographic location and/or desk) (Can be embedded within encrypted data section.)FIX.4.1
116OnBehalfOfSubIDStringNTrading partner SubID used when delivering messages via a third party. (Can be embedded within encrypted data section.)FIX.4.0
144OnBehalfOfLocationIDStringNTrading partner LocationID (i.e. geographic location and/or desk) used when delivering messages via a third party. (Can be embedded within encrypted data section.)FIX.4.1
129DeliverToSubIDStringNTrading partner SubID used when delivering messages via a third party. (Can be embedded within encrypted data section.)FIX.4.0
145DeliverToLocationIDStringNTrading partner LocationID (i.e. geographic location and/or desk) used when delivering messages via a third party. (Can be embedded within encrypted data section.)FIX.4.1
43PossDupFlagBooleanNAlways required for retransmitted messages, whether prompted by the sending system or as the result of a resend request. (Can be embedded within encrypted data section.)
2 enum values
ValueNameDescription
NOriginalTransmissionOriginal transmission
YPossibleDuplicatePossible duplicate
FIX.4.0
97PossResendBooleanNRequired when message may be duplicate of another message sent under a different sequence number. (Can be embedded within encrypted data section.)
2 enum values
ValueNameDescription
NOriginalTransmissionOriginal transmission
YPossibleResendPossible resend
FIX.4.0
52SendingTimeUTCTimestampY(Can be embedded within encrypted data section.)FIX.4.0
122OrigSendingTimeUTCTimestampNRequired for message resent as a result of a ResendRequest. If data is not available set to same value as SendingTime (Can be embedded within encrypted data section.)FIX.4.0
212XmlDataLenLengthNRequired when specifying XmlData to identify the length of a XmlData message block. (Can be embedded within encrypted data section.)FIX.4.2
213XmlDatadataNCan contain a XML formatted message block (e.g. FIXML). Always immediately follows XmlDataLen field. (Can be embedded within encrypted data section.) See Appendix M – FIXML SupportFIX.4.2
347MessageEncodingStringNType of message encoding (non-ASCII characters) used in a message’s "Encoded" fields. Required if any "Encoding" fields are used.
4 enum values
ValueNameDescription
EUC-JPEUCJP(for using EUC)
ISO-2022-JPISO2022JP(for using JIS)
Shift_JISShiftJIS(for using SJIS)
UTF-8UTF8(for using Unicode)
FIX.4.2
369LastMsgSeqNumProcessedintNThe last MsgSeqNum value received and processed. Can be specified on every message sent. Useful for detecting a backlog with a counterparty.FIX.4.2
370OnBehalfOfSendingTimeUTCTimestampNUsed when a message is sent via a "hub" or "service bureau". If A sends to Q (the hub) who then sends to B via a separate FIX session, then when Q sends to B the value of this field should represent the SendingTime on the message A sent to Q. (always expressed in UTC (Universal Time Coordinated, also known as "GMT")FIX.4.2
70AllocIDStringYUnique identifier for allocation message. (Prior to FIX 4.1 this field was of type int)FIX.2.7
71AllocTransTypecharYIdentifies allocation transaction type
6 enum values
ValueNameDescription
0NewNew
1ReplaceReplace
2CancelCancel
3PreliminaryPreliminary (without MiscFees and NetMoney)
4CalculatedCalculated (includes MiscFees and NetMoney)
5CalculatedWithoutPreliminaryCalculated without Preliminary (sent unsolicited by broker, includes MiscFees and NetMoney)
FIX.2.7
72RefAllocIDStringNRequired for AllocTransType = Calculated, Replace, or CancelFIX.2.7
196AllocLinkIDStringNCan be used to link two different Allocation messages (each with unique AllocID) together, i.e. for F/X "Netting" or "Swaps"FIX.4.1
197AllocLinkTypeintNCan be used to link two different Allocation messages and identifies the type of link. Required if AllocLinkID is specified.
2 enum values
ValueNameDescription
0FXNettingF/X Netting
1FXSwapF/X Swap
FIX.4.1
73NoOrdersintNIndicates number of orders to be combined for allocation. If order(s) were manually delivered set to 1 (one).FIX.2.7
11ClOrdIDStringNOrder ID assigned by client if order(s) were electronically delivered and executed. If order(s) were manually delivered this field should contain string "MANUAL".FIX.4.0
37OrderIDStringNUnique identifier for Order as assigned by broker. Uniqueness must be guaranteed within a single trading day. Firms which accept multi-day orders should consider embedding a date within the OrderID field to assure uniqueness across days.FIX.4.0
198SecondaryOrderIDStringNCan be used to provide order id used by exchange or executing system.FIX.4.1
66ListIDStringNRequired for List Orders.FIX.4.0
105WaveNoStringNIdentifier to aid in the management of multiple lists derived from a single, master list.FIX.4.0
124NoExecsintNIndicates 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.FIX.4.0
32LastSharesQtyNNumber of shares in individual execution. Required if NoExecs > 0FIX.4.0
17ExecIDStringNUnique identifier of execution message as assigned by broker (will be 0 (zero) for ExecTransType=3 (Status)). Uniqueness must be guaranteed within a single trading day or the life of a multi-day order. Firms which accept multi-day orders should consider embedding a date within the ExecID field to assure uniqueness across days. (Prior to FIX 4.1 this field was of type int)FIX.4.0
31LastPxPriceNPrice of individual execution. Required if NoExecs > 0FIX.4.0
29LastCapacitycharNCan be specified by broker for AllocTransTyp=Calculated
4 enum values
ValueNameDescription
1AgentAgent
2CrossAsAgentCross as agent
3CrossAsPrincipalCross as principal
4PrincipalPrincipal
FIX.4.1
54SidecharYSide of order
9 enum values
ValueNameDescription
1BuyBuy
2SellSell
3BuyMinusBuy minus
4SellPlusSell plus
5SellShortSell short
6SellShortExemptSell short exempt
7UndisclosedUndisclosed (valid for IOI and List Order messages only)
8CrossCross (orders where counterparty is an exchange, valid for all messages except IOIs)
9CrossShortCross short
FIX.2.7
55SymbolStringYTicker symbolFIX.2.7
65SymbolSfxStringNAdditional information about the security (e.g. preferred, warrants, etc.). Note also see SecurityType. Valid values: As defined in the NYSE Stock and bond Symbol Directory and in the AMEX Fitch DirectoryFIX.2.7
48SecurityIDStringNCUSIP or other alternate security identifierFIX.2.7
22IDSourceStringNIdentifies class of alternative SecurityID
9 enum values
ValueNameDescription
1CUSIPCUSIP
2SEDOLSEDOL
3QUIKQUIK
4ISINNumberISIN number
5RICCodeRIC code
6ISOCurrencyCodeISO Currency Code
7ISOCountryCodeISO Country Code
8ExchangeSymbolExchange Symbol
9ConsolidatedTapeAssociationConsolidated Tape Association (CTA) Symbol (SIAC CTS/CQS line format)
FIX.2.7
167SecurityTypeStringNMust 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.
33 enum values
ValueNameDescription
?WildcardWildcard entry (used on Security Definition Request message)
BABankersAcceptanceBankers Acceptance
CBConvertibleBondConvertible Bond (Note not part of ISITC spec)
CDCertificateOfDepositCertificate Of Deposit
CMOCollateralizedMortgageObligationCollateralize Mortgage Obligation
CORPCorporateBondCorporate Bond
CPCommercialPaperCommercial Paper
CPPCorporatePrivatePlacementCorporate Private Placement
CSCommonStockCommon Stock
FHAFederalHousingAuthorityFederal Housing Authority
FHLFederalHomeLoanFederal Home Loan
FNFederalNationalMortgageAssociationFederal National Mortgage Association
FORForeignExchangeContractForeign Exchange Contract
FUTFutureFuture
GNGovernmentNationalMortgageAssociationGovernment National Mortgage Association
GOVTTreasuriesAgencyDebentureTreasuries + Agency Debenture
IETIOETTEMortgageMortgage IOETTE
MFMutualFundMutual Fund
MIOMortgageInterestOnlyMortgage Interest Only
MPOMortgagePrincipalOnlyMortgage Principal Only
MPPMortgagePrivatePlacementMortgage Private Placement
MPTMiscellaneousPassThroughMiscellaneous Pass-Thru
MUNIMunicipalBondMunicipal Bond
NONENoSecurityTypeNo ISITC Security Type
OPTOptionOption
PSPreferredStockPreferred Stock
RPRepurchaseAgreementRepurchase Agreement
RVRPReverseRepurchaseAgreementReverse Repurchase Agreement
SLStudentLoanMarketingAssociationStudent Loan Marketing Association
TDTimeDepositTime Deposit
USTBUSTreasuryBillOldUS Treasury Bill
WARWarrantWarrant
ZOOCatsTigersAndLionsCats, Tigers & Lions (a real code: US Treasury Receipts)
FIX.4.1
200MaturityMonthYearMonthYearNSpecifiesthe month and year of maturity. Required if MaturityDay is specified.FIX.4.1
205MaturityDayDayOfMonthNCan be used in conjunction with MaturityMonthYear to specify a particular maturity date.FIX.4.1
201PutOrCallintNFor Options.
2 enum values
ValueNameDescription
0PutPut
1CallCall
FIX.4.1
202StrikePricePriceNFor Options.FIX.4.1
206OptAttributecharNFor Options.FIX.4.1
231ContractMultiplierfloatNFor Fixed Income, Convertible Bonds, Derivatives, etc. Note: If used, quantities should be expressed in the "nominal" (e.g. contracts vs. shares) amount.FIX.4.2
223CouponRatefloatNFor Fixed Income.FIX.4.2
207SecurityExchangeExchangeNCan be used to identify the security.FIX.4.1
106IssuerStringNCompany name of security issuer (e.g. International Business Machines)FIX.3.0
348EncodedIssuerLenLengthNMust be set if EncodedIssuer field is specified and must immediately precede it.FIX.4.2
349EncodedIssuerdataNEncoded (non-ASCII characters) representation of the Issuer field in the encoded format specified via the MessageEncoding field.FIX.4.2
107SecurityDescStringNSecurity description.FIX.3.0
350EncodedSecurityDescLenLengthNMust be set if EncodedSecurityDesc field is specified and must immediately precede it.FIX.4.2
351EncodedSecurityDescdataNEncoded (non-ASCII characters) representation of the SecurityDesc field in the encoded format specified via the MessageEncoding field.FIX.4.2
53SharesQtyYTotal number of shares allocated to all accountsFIX.2.7
30LastMktExchangeNMarket of the executions.FIX.4.0
336TradingSessionIDStringNIdentifier for Trading Session Can be used to represent a specific market trading session (e.g. "PRE-OPEN", "CROSS_2", "AFTER-HOURS", "TOSTNET1", "TOSTNET2", etc). Values should be bi-laterally agreed to between counterparties.FIX.4.2
6AvgPxPriceYFor F/X orders, should be the "all-in" rate (spot rate adjusted for forward points).FIX.2.7
15CurrencyCurrencyNCurrency of AvgPx. Should be the currency of the local market or exchange where the trade was conducted.FIX.2.7
74AvgPrxPrecisionintNAbsence of this field indicates that default precision arranged by the broker/institution is to be usedFIX.2.7
75TradeDateLocalMktDateYIndicates date of trade referenced in this message in YYYYMMDD format. Absence of this field indicates current day (expressed in local time at place of trade).FIX.2.7
60TransactTimeUTCTimestampNDate/time when allocation is generatedFIX.2.7
63SettlmntTypcharNAbsence of this field is interpreted as Regular
10 enum values
ValueNameDescription
0RegularRegular
1CashCash
2NextDayNext Day
3TPlus2T+2
4TPlus3T+3
5TPlus4T+4
6FutureFuture
7WhenAndIfIssuedWhen Issued
8SellersOptionSellers Option
9TPlus5T+ 5
FIX.2.7
64FutSettDateLocalMktDateN"Settlement Date". Required with SettlmntTyp other than regularFIX.2.7
381GrossTradeAmtAmtNExpressed in same currency as AvgPx. Sum of (AllocShares * AllocAvgPx or AllocPrice).FIX.4.2
118NetMoneyAmtNExpressed in same currency as AvgPx. Sum of AllocNetMoney.FIX.4.0
77OpenClosecharNIndicates whether the resulting position after a trade should be an opening position or closing position. Used for omnibus accounting - where accounts are held on a gross basis instead of being netted together.
2 enum values
ValueNameDescription
CCloseClose
OOpenOpen
FIX.2.7
58TextStringNFree format text string (Note: this field does not have a specified maximum length)FIX.2.7
354EncodedTextLenLengthNMust be set if EncodedText field is specified and must immediately precede it.FIX.4.2
355EncodedTextdataNEncoded (non-ASCII characters) representation of the Text field in the encoded format specified via the MessageEncoding field.FIX.4.2
157NumDaysInterestintNApplicable for Convertible Bonds and fixed incomeFIX.4.1
158AccruedInterestRatefloatNApplicable for Convertible Bonds and fixed incomeFIX.4.1
78NoAllocsintNIndicates number of allocation groups to follow.FIX.2.7
79AllocAccountStringNMay be the same value as BrokerOfCredit if ProcessCode is step-out or soft-dollar step-out and Institution does not wish to disclose individual account breakdowns to the ExecBroker. Required if NoAllocs > 0. Must be first field in repeating group.FIX.4.0
366AllocPricePriceNUsed when performing "executed price" vs. "average price" allocations (e.g. Japan). AllocAccount plus AllocPrice form a unique Allocs entry. Used in lieu of AllocAvgPx.FIX.4.2
80AllocSharesQtyYNumber of shares to be allocated to specific sub-account (Prior to FIX 4.2 this field was of type int)FIX.4.0
81ProcessCodecharNProcessing code for sub-account. Absence of this field in AllocAccount / AllocPrice/AllocShares / ProcessCode instance indicates regular trade.
7 enum values
ValueNameDescription
0Regularregular
1SoftDollarsoft dollar
2StepInstep-in
3StepOutstep-out
4SoftDollarStepInsoft-dollar step-in
5SoftDollarStepOutsoft-dollar step-out
6PlanSponsorplan sponsor
FIX.4.0
92BrokerOfCreditStringNRequired if ProcessCode is step-out or soft-dollar step-outFIX.4.0
208NotifyBrokerOfCreditBooleanNIndicates whether or not details should be communicated to BrokerOfCredit (i.e. step-in broker).
2 enum values
ValueNameDescription
NDetailsShouldNotBeCommunicatedDetails should not be communicated
YDetailsShouldBeCommunicatedDetails should be communicated
FIX.4.1
209AllocHandlInstintNIndicates how the receiver (i.e. third party) of Allocation message should handle/process the account details.
3 enum values
ValueNameDescription
1MatchMatch
2ForwardForward
3ForwardAndMatchForward and Match
FIX.4.1
161AllocTextStringNFree format text field related to this AllocAccountFIX.4.1
360EncodedAllocTextLenLengthNMust be set if EncodedAllocText field is specified and must immediately precede it.FIX.4.2
361EncodedAllocTextdataNEncoded (non-ASCII characters) representation of the AllocText field in the encoded format specified via the MessageEncoding field.FIX.4.2
76ExecBrokerStringNRequired for step-in and step-out tradesFIX.4.0
109ClientIDStringNUsed for firm identification in third-party transactions (should not be a substitute for OnBehalfOfCompID/DeliverToCompID).FIX.4.0
12CommissionAmtNCommission. Note if CommType is percentage, Commission of 5% should be represented as .05.FIX.4.0
13CommTypecharNCommission type
3 enum values
ValueNameDescription
1PerUnitper share
2Percentpercentage
3Absoluteabsolute
FIX.4.0
153AllocAvgPxPriceNAvgPx for this AllocAccount. For F/X orders, should be the "all-in" rate (spot rate adjusted for forward points) for this allocation.FIX.4.1
154AllocNetMoneyAmtNNetMoney for this AllocAccount ((AllocShares * AllocAvgPx) - Commission - sum of MiscFeeAmt + AccruedInterestAmt) if a Sell ((AllocShares * AllocAvgPx) + Commission + sum of MiscFeeAmt + AccruedInterestAmt) if a BuyFIX.4.1
119SettlCurrAmtAmtNAllocNetMoney in SettlCurrency for this AllocAccount if SettlCurrency is different from "overall" CurrencyFIX.4.0
120SettlCurrencyCurrencyNSettlCurrency for this AllocAccount if different from "overall" Currency. Required if SettlCurrAmt is specified.FIX.4.0
155SettlCurrFxRatefloatNForeign exchange rate used to compute SettlCurrAmt from Currency to SettlCurrencyFIX.4.1
156SettlCurrFxRateCalccharNSpecifies whether the SettlCurrFxRate should be multiplied or dividedFIX.4.1
159AccruedInterestAmtAmtNApplicable for Convertible Bonds and fixed incomeFIX.4.1
160SettlInstModecharNType of Settlement Instructions which will be provided via Settlement Instructions message (0=Default, 1=Standing Instructions, 2=Specific Allocation Account Overriding, 3=Specific Allocation Account Standing)
4 enum values
ValueNameDescription
0DefaultDefault
1StandingInstructionsProvidedStanding Instructions Provided
2SpecificAllocationAccountOverridingSpecific Allocation Account Overriding
3SpecificAllocationAccountStandingSpecific Allocation Account Standing
FIX.4.1
136NoMiscFeesintNRequired if any miscellaneous fees are reported. Indicates number of repeating entries. Repeating group within Alloc repeating group. ** Nested Repeating Group follows **FIX.4.0
137MiscFeeAmtAmtNRequired if NoMiscFees > 0FIX.4.0
138MiscFeeCurrCurrencyNRequired if NoMiscFees > 0FIX.4.0
139MiscFeeTypecharNRequired if NoMiscFees > 0
9 enum values
ValueNameDescription
1RegulatoryRegulatory (e.g. SEC)
2TaxTax
3LocalCommissionLocal Commission
4ExchangeFeesExchange Fees
5StampStamp
6LevyLevy
7OtherOther
8MarkupMarkup
9ConsumptionTaxConsumption Tax
FIX.4.0
StandardTrailer [Component]YThe standard FIX message trailerFIX.2.7
93SignatureLengthLengthNRequired when trailer contains signature. Note: Not to be included within SecureData fieldFIX.4.0
89SignaturedataNNote: Not to be included within SecureData fieldFIX.4.0
10CheckSumStringY(Always unencrypted, always last field in message)FIX.4.0