Log in

J Allocation Instruction

This message used to to specify how an order or set of orders should be subdivided amongst one or more accounts. Prior to FIX 4.4, this message used the name "Allocation", and was also used to communicate fee and expense details from the sell-side to the buy-side. This role has now been removed from and is now performed by Allocation Report <35=AS> and Confirmation <35=AK>. The Allocation Report <35=AS> message should be used for the sell-side-initiated allocation role as defined in previous versions of the protocol.

The response to this message is the Allocation Instruction Ack <35=P> message.

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 accounts and their respective order quantities which make up the order. This is a regulatory requirement in certain markets and for certain types of securities.

This message can be submitted with AllocTransType (71) = "new", "cancel" or "replace". The AllocType (626) field indicates the type or purpose of the message:

AllocSettlInstType (780) is used to specify full settlement instruction details, to provide a reference to a settlement instruction held on a database of such instructions or to instruct the receiving party to perform one of the following actions:

  • Use default instructions
  • Derive the instructions from the parameters of the trade
  • Phone for instructions

AllocID (70) should be unique for all messages with AllocTransType (71) = "new".

When AllocTransType (71) = "replace" or "cancel", RefAllocID (72) and AllocCancReplaceReason (796) are required.

To reject an Allocation Instruction, an Allocation Instruction Ack <35=P> with AllocStatus (87) = "'Block-level reject" or "Account-level reject" should be used. Block-level reject is used to reject the entire message, e.g. due to one or more of the orders not matching. An account-level reject is used when the block-level matches successfully but one or more of the constituent account-level details failed validation, e.g. the account was not found. In the latter case, the rejecting party can optionally notify the instructing party of those allocation details that are being rejected by listing the offending account IDs in the Allocation Instruction Ack <35=P>. AllocGrp exists for this purpose.

The correct response to a block-level reject Allocation Instruction Ack <35=P> is a new Allocation Instruction with AllocTransType (71) = "new", as the previous message has been rejected in entirety. In the case of an account-level reject, either:

  • the original Allocation Instruction should be cancelled (an Allocation Instruction referencing the original in RefAllocID (72), with AllocTransType (71) = "cancel") then reinstated (a second Allocation Instruction with AllocTransType (71) = "new")
  • the original Allocation Instruction should be fully replaced (an Allocation Instruction referencing the original in RefAllocID (72), with AllocTransType (71) = "replace"). A replacement allocation message must contain all data for the replacement allocation. It is the responsibility of the recipient to identify which fields have been changed

Optionally, an Allocation Instruction with AllocTransType (71) = "cancel" or "replace" can be rejected if an Allocation Instruction Ack <35=P> with status = "accepted" has already been sent. Manual communication would then be required to effect the required changes. This approach would generally be required where the generation of the accepted Allocation Instruction Ack <35=P> is used to move the allocation details into downstream processing, e.g. confirmation generation. In which case, a subsequent cancellation or amendment may require the details to be retrieved from the downstream process.

Where an amendment or cancellation of an Allocation Instruction has taken place out outside of FIX, an Allocation Report <35=AS> message can be sent to confirm that the relevant action has taken place.

Where settling in markets where multiple alternative settlement locations exist, it is recommended that the settlement location be specified on each allocation detail within the AllocGrp component. A NestedParties component block exists for this purpose.

Quantity (53) must equal the total quantity allocated. If present, the total quantity in the execution section must also be equal to this value. The total quantity of the allocation does not necessarily have to equal the total quantity of the orders being allocated. For example in good-til (GT) orders, especially where multi-day average pricing is taking place. The quantity of each order being booked must also be specified on the message. This will be equal to the order quantity if the entire order is being booked, though can be less if only part of the order is being booked. The sum of the order booking quantities must be equal to Quantity (53).

The number of sub-account instances is indicated in the AllocGrp component.

Multiple orders can be combined for allocation or for AllocType (626) = "Ready-To-Book" or for AllocType (626) = "Warehouse instruction". Note that combined orders must refer to the same instrument and have the same trade date, settlement date and side. The identification of the orders to be combined can be achieved in one of two ways:

  • By identifying the number of orders in the NoOrders (73) field and each individual order in the OrderID (37) fields. The AllocNoOrdersType (857) field is used to denote that this is happening and takes value "1=Explicit list provided". If any orders were handled outside FIX, the ClOrdID (11) must be set to 'MANUAL'. Regardless of whether the orders were handled within or outside FIX, the order quantity and average price must also be specified for each order. This is to assist in validating the message and, for manual orders, to help identify the correct orders to book.
  • By stating that an unspecified group of orders is to be combined. The NoOrders (73) field in this case is left blank. The AllocNoOrdersType (857) field is set to "0=Not specified" to specify that this is happening. This approach is only recommended where either the number of orders being booked is extremely large or some kind of aggregation rule is being used.

Multiple executions can be combined for allocation by identifying the number of executions in the NoExecs (124) field and each individual execution in the ExecID (17) fields. Combined executions must refer to the same instrument, trade date, settlement date and side.

Except where AllocTransType (71) = 'Cancel' or where AllocNoOrdersType (857) = "Not specified", the list of orders being booked or allocated must be specified by using their ClOrdID (11). If any orders were handled outside FIX, the ClOrdID (11) must be set to 'MANUAL'. Regardless of whether the orders were handled within or outside FIX, and where the orders are specified, the order quantity and average price must also be specified for each order. This is to assist in validating the message and, for manual orders, to help identify the correct orders to book.

Structure

TagNameTypeRequiredDescription
Component
Required
70String
Required
Unique identifier for this allocation instruction message
2758StringMay be used to link to a previously submitted AllocationInstructionAlertRequest(35=DU) message
71Char Enum
Required
626Int Enum
Required
Specifies the purpose or type of Allocation message
793StringOptional second identifier for this allocation instruction (need not be unique)
72StringRequired for AllocTransType = Replace or Cancel
796Int EnumRequired for AllocTransType = Replace or Cancel
808Int EnumRequired if AllocType = 8 (Request to Intermediary)
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
1730StringGroup identifier assigned by the clearinghouse
1728StringGroup identifier assigned by the firm
466StringCan be used with AllocType=" Ready-To-Book "
857Int EnumIndicates 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
ComponentIndicates number of orders to be combined for allocation. If order(s) were manually delivered set to 1 (one).Required when AllocNoOrdersType = 1
ComponentIndicates number of individual execution or trade entries. Absence indicates that no individual execution or trade entries are included. Primarily used to support step-outs
570Boolean Enum
700Boolean
574String Enum
54Char Enum
Required
Component
Required
For NDFs fixing date and time can be optionally specified using MaturityDate and MaturityTime
Component
Component
Component
Component
53Quantity
Required
Total quantity (e.g. number of shares) allocated to all accounts, or that is Ready-To-Book
854Int Enum
2974StringMay be used as an alternative to attribute based subgrouping
30ExchangeMarket of the executions
229LocalMktDate
336String Enum
625String Enum
423Int Enum
Component
6PriceFor FX orders, should be the "all-in" rate (spot rate adjusted for forward points), expressed in terms of Currency(15)
860Price
Component
15CurrencyCurrency of AvgPx. Should be the currency of the local market or exchange where the trade was conducted
2897String Enum
74IntAbsence of this field indicates that default precision arranged by the broker/institution is to be used
2795Int Enum
Component
75LocalMktDate
Required
60UTCTimestampDate/time when allocation is generated
63String Enum
64LocalMktDateTakes precedence over SettlType value and conditionally required/omitted for specific SettlType values
775Int EnumMethod 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
381AmountExpressed 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
238Amount
237Amount
118AmountExpressed in same currency as AvgPx. Sum of AllocNetMoney
77Char Enum
754BooleanIndicates if Allocation has been automatically accepted on behalf of the Take-up Firm by the Clearing House
58String
354LengthMust 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
158PercentageApplicable for Convertible Bonds and fixed income
159AmountApplicable for Convertible Bonds and fixed income
540Amount
738Amount
920AmountFor repurchase agreements the accrued interest on termination
921AmountFor repurchase agreements the start (dirty) cash consideration
922AmountFor repurchase agreements the end (dirty) cash consideration
650Boolean Enum
Component
Component
Component
Component
892IntIndicates 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
893Boolean EnumIndicates whether this is the last fragment in a sequence of message fragments. Only required where message has been fragmented
ComponentConditionally required except when AllocTransType = Cancel, or when AllocType = "Ready-to-book" or "Warehouse instruction"
819Int EnumIndicates if an allocation is to be average priced. Is also used to indicate if average price allocation group is complete or incomplete
1731StringFirm designated group identifier for average pricing
715LocalMktDateIndicates Clearing Business Date for which transaction will be settled
828Int EnumIndicates trade type of allocation. May be used as an alternative to AllocGroupSubQtyID(2974) for subgrouping
829Int EnumIndicates trade subtype of allocation
855Int Enum
2896Int Enum
1390Int EnumMay be used as an alternative to AllocGroupSubQtyID(2974) for subgrouping
1031MultipleStringValue EnumMay be used as an alternative to AllocGroupSubQtyID(2974) for subgrouping
1937Int Enum
2374String
2372LengthMust be set if EncodedTradeContinuationText(2371) field is specified and must immediately precede it
2371DataEncoded (non-ASCII characters) representation of the TradeContinuationText(2374) field in the encoded format specified via the MessageEncoding(347) field
582Int EnumIndicates CTI of original trade marked for allocation
578StringIndicates input source of original trade marked for allocation
442Char EnumIndicates MultiLegReportType of original trade marked for allocation
1011StringUsed to identify the event or source which gave rise to a message
991PriceSpecifies the rounded price to quoted precision
Component
1430Char EnumUsed 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
2334StringConditionally required when RefRiskLimitCheckIDType(2335) is specified
2335Int EnumConditionally required when RefRiskLimitCheckID(2334) is specified
2343Int Enum
Component
Required