Definition
This message is used in a 3-party allocation model (buy-side and sell-side using a central clearing entity) where notification of group creation and group updates to counterparties is needed. The message will also carry trade information that comprised the group to the counterparties.
Message structure 4219 distinct fields
Source order, including nested components and groups. Group counts precede the repeated entries. “Required here” is relative to the enclosing component or group, not unconditional in the message. A dash means not marked required; conditional requirements remain in the source notes. This is a reference, not a counterparty-specific validator.
Nested fields load when needed. Open the full static layout (also works without JavaScript).
StandardHeaderComponentRequired
MsgType = BM
StandardHeader definition & usage →
Open this block to load its fields in message context, or follow the definition link.
Unique identifier for this allocation instruction alert message
Specifies the purpose or type of Allocation message
Identifier of the request this message is responding to when responding to an AllocationInstructionAlertRequest(35=DU).
Optional second identifier for this allocation instruction (need not be unique)
Required for AllocTransType = Replace or Cancel
Required for AllocTransType = Replace or Cancel
Gives the reason for replacing or cancelling the allocation instruction
Required if AllocType = 8 (Request to Intermediary)
Indicates status that is requested to be transmitted to counterparty by the intermediary (i.e. clearing house)
Can be used to link two different Allocation messages (each with unique AllocID) together, i.e. for F/X "Netting" or "Swaps"
Can be used to link two different Allocation messages and identifies the type of link. Required if AllocLinkID is specified.
Group identifier assigned by the clearinghouse
Firm assigned entity identifier for the allocation
Can be used with AllocType=" Ready-To-Book "
Indicates how the orders being booked and allocated by an Allocation Instruction or Allocation Report message are identified, e.g. by explicit definition in the OrdAllocGrp or ExecAllocGrp components , or not identified explicitly.
OrdAllocGrpRepeating groupCount tag 73—
Indicates number of orders to be combined for allocation. If order(s) were manually delivered set to 1 (one).Required when AllocNoOrdersType = 1
OrdAllocGrp definition & usage →
Open this block to load its fields in message context, or follow the definition link.
ExecAllocGrpRepeating groupCount tag 124—
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.
ExecAllocGrp definition & usage →
Open this block to load its fields in message context, or follow the definition link.
InstrumentComponentRequired
Instrument definition & usage →
Open this block to load its fields in message context, or follow the definition link.
InstrumentExtensionComponent—
InstrumentExtension definition & usage →
Open this block to load its fields in message context, or follow the definition link.
FinancingDetailsComponent—
FinancingDetails definition & usage →
Open this block to load its fields in message context, or follow the definition link.
UndInstrmtGrpRepeating groupCount tag 711—
UndInstrmtGrp definition & usage →
Open this block to load its fields in message context, or follow the definition link.
InstrmtLegGrpRepeating groupCount tag 555—
InstrmtLegGrp definition & usage →
Open this block to load its fields in message context, or follow the definition link.
When not using allocation groups, this is the total quantity (e.g. number of shares) allocated to all accounts, or that is Ready-To-Book. When using allocation groups, this is the quantity added or removed when trades are added to or removed from an allocation group. To remove quantity from the allocation group a negative value is specified in Quantity(53). When the allocation group quantity is unchanged, such as when AllocType(626) changes from 12(Incomplete group) to 13(Complete group) , the value for Quantity(53) should be zero (0).
AllocGroupSubQtyGrpRepeating groupCount tag 2975—
AllocGroupSubQtyGrp definition & usage →
Open this block to load its fields in message context, or follow the definition link.
Market of the executions.
PriceQualifierGrpRepeating groupCount tag 2709—
PriceQualifierGrp definition & usage →
Open this block to load its fields in message context, or follow the definition link.
For F/X orders, should be the "all-in" rate (spot rate adjusted for forward points).
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.
Maybe used to indicate the highest price within the specified allocation group.
Maybe used to indicate the lowest price within the specified allocation group.
SpreadOrBenchmarkCurveDataComponent—
SpreadOrBenchmarkCurveData definition & usage →
Open this block to load its fields in message context, or follow the definition link.
Currency of AvgPx. Should be the currency of the local market or exchange where the trade was conducted.
Absence of this field indicates that default precision arranged by the broker/institution is to be used
PartiesRepeating groupCount tag 453—
Open this block to load its fields in message context, or follow the definition link.
Date/time when allocation is generated
Identifies status of allocation.
Takes precedence over SettlType value and conditionally required/omitted for specific SettlType values.
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.
Expressed in same currency as AvgPx. Sum of (AllocQty * AllocAvgPx or AllocPrice).
Expressed in same currency as AvgPx. Sum of AllocNetMoney.
Indicates if Allocation has been automatically accepted on behalf of the Carry Firm by the Clearing House
Must be set if EncodedText field is specified and must immediately precede it.
Encoded (non-ASCII characters) representation of the Text field in the encoded format specified via the MessageEncoding field.
Applicable for Convertible Bonds and fixed income
Applicable for Convertible Bonds and fixed income
Applicable for Convertible Bonds and fixed income (REMOVED FROM THIS LOCATION AS OF FIX 4.4, REPLACED BY AllocAccruedInterest)
(Deprecated) use AccruedInterestAmt Sum of AccruedInterestAmt within repeating group.
For repurchase agreements the accrued interest on termination.
For repurchase agreements the start (dirty) cash consideration
For repurchase agreements the end (dirty) cash consideration
StipulationsRepeating groupCount tag 232—
Stipulations definition & usage →
Open this block to load its fields in message context, or follow the definition link.
YieldDataComponent—
YieldData definition & usage →
Open this block to load its fields in message context, or follow the definition link.
PositionAmountDataRepeating groupCount tag 753—
PositionAmountData definition & usage →
Open this block to load its fields in message context, or follow the definition link.
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.
Indicates whether this is the last fragment in a sequence of message fragments. Only required where message has been fragmented.
AllocGrpRepeating groupCount tag 78—
Indicates number of allocation groups to follow.
Not required for AllocTransType=Cancel
Not required for AllocType=" Ready-To-Book " or "Warehouse instruction".
Open this block to load its fields in message context, or follow the definition link.
Indicates if an allocation is to be average priced. Is also used to indicate if average price allocation group is complete or incomplete.
Firm designated group identifier for average pricing.
Indicates Clearing Business Date for which transaction will be settled.
Indicates trade type of allocation.
Indicates trade subtype of allocation.
Indicates CTI of original trade marked for allocation.
Indicates input source of original trade marked for allocation.
Indicates MultiLegReportType of original trade marked for allocation.
Used to identify the event or source which gave rise to a message.
Specifies the rounded price to quoted precision.
StandardTrailerComponentRequired
StandardTrailer definition & usage →
Open this block to load its fields in message context, or follow the definition link.