Allocation Management FIXML API - Conceptual Workflows
This section illustrates the interactions between the various organizations using conceptual messages, which depict the messaging function. Â Â
- 1 Give-Up Allocation
- 1.1 Executing Firm Marks a Trade for Give-up
- 1.2 Executing Firm Marks a Trade for Give-Up - Rejected by Clearing System
- 1.3 Executing Firm Allocates Trade - Allocation Claimed by Claiming Firm
- 1.4 Executing Firm Allocates Trade - Allocation Refused by Claiming Firm
- 1.5 Executing Firm Amends an Allocation - Pre-Claim
- 1.6 Claiming Firm Amends an Allocation - Pre-Claim
- 1.7 Executing Firm Cancels an Allocation - Pre-Claim
- 1.8 Claiming Firm Amends an Allocation - Post-Claim
- 1.9 Executing Firm Cancels a Give-Up Group
- 1.10 Executing Firm Un-Marks a Trade From Give-Up
- 2 Average Price Allocation
- 2.1 Executing Firm Marks Trades for Average Pricing
- 2.2 Executing Firm Completes an Average Price Group
- 2.3 Executing Firm Allocates an Average Price Group After Group Completion - Clearing System Splits Allocation
- 2.4 Executing Firm Amends Average Pricing Allocation
- 2.5 Executing Firm Un-Marks a Trade From an Average Price Group
- 2.6 Executing Firm Un-Completes an Average Price GroupÂ
- 2.7 Executing Firm Cancels an Average Price Group
- 2.8 Sub-Allocation and Average Pricing Allocations
- 2.8.1 Sub-Allocation Modification and Cancellation
- 2.8.2 Reversal of Accepted Allocations
- 2.8.3 Claiming Firm Requests Reversal - Claimed by Executing Firm
- 2.8.4 Claiming Firm Requests Reversal - Refused by Executing Firm
- 2.8.5 Executing Firm Requests Reversal
- 2.8.6 Initiator of the Reversal Request Cancels the Request
- 2.8.7 Cross-Exchange Give-Up Allocation
- 2.8.8 CME Executing Firm Allocates Trade to SGX Firm; SGX Firm Claims
- 2.8.9 SGX Executing Firm Allocates Trade to CME Firm; CME Firm ClaimsÂ
- 2.8.10 CME Executing Firm Cancels an Allocation - Pre-claim
- 2.8.11 CME Claim Firm Reverses an Accepted Allocation
Give-Up Allocation
This section describes the work flows used in the vanilla give-up process.
Executing Firm Marks a Trade for Give-up
Scenario 1: Specifying Allocation Instructions Later
In this scenario, an executing firm marks a trade for give-up:
The executing firm either submits a new trade or amends a previously submitted trade with an indicator marking it for give-up.
The clearing system acknowledges the trade submission or amendment, creates a give-up allocation group, and indicates the status.
The executing firm submits allocation instructions, allocating the group to a single claiming firm.
The clearing system:
Acknowledges the allocation to the executing firm.
Notifies the claiming firm of the allocation.
Scenario 2: Marking and Specifying Allocation Instructions
In this scenario, the executing firm marks a trade by specifying allocation instructions, bypassing the need to send a separate instruction to allocate to a claiming firm:
The executing firm either submits a new trade, or amends a previously submitted trade, with an indicator marking it for give-up, and including allocation information.
The clearing system:
Acknowledges the trade submission or amendment.
Creates a give-up allocation group, and indicates its status to the claiming firm.
Acknowledges an allocation to the executing firm.
Notifies the claiming firm of a new allocation.
Scenario 3: Marking and Specifying Multiple Allocation Instructions
In this scenario, the trade has already been marked for give-up. The executing firm submits an allocation with multiple allocation instructions targeting multiple claiming firms:
The executing firm receives multiple acknowledgments for the allocation instructions; one for each instruction.
Each claiming firm is notified of the new allocation.
Executing Firm Marks a Trade for Give-Up - Rejected by Clearing System
In this scenario, the clearing system rejects an inbound request to allocate a trade:
The executing firm either submits a new trade or amends a previously submitted trade with an indicator marking it for give-up and includes allocation information. This action proves invalid.
The clearing system responds with a clearing system reject. The claiming firm is never notified.
Executing Firm Allocates Trade - Allocation Claimed by Claiming Firm
In this scenario, the executing firm marked a trade for give-up and allocated it to a claiming firm. The claiming firm claims the allocation:
The claiming firm claims the allocation.
The clearing system:
Sends the claiming firm an acknowledgment.
Notifies the executing firm of the claim.
Executing Firm Allocates Trade - Allocation Refused by Claiming Firm
In this scenario, the executing firm marked a trade for give-up and allocated it to a claiming firm. The claiming firm refuses the allocation:
The claiming firm refuses the allocation.Â
The clearing system:
Acknowledges the claiming firm of the refusal.
Notifies the executing firm of the refusal.
Executing Firm Amends an Allocation - Pre-Claim
Scenario 1: Executing Firm Amends Allocation to a New Claiming Firm
In this scenario, the executing firm allocated a trade to a claiming firm and amended it to allocate it to a different claiming firm before the first claiming firm claimed the trade:
The executing firm amends the allocation to give up the entirety of the trade to claiming firm 2.
The clearing system:
Acknowledges the amendment to the executing firm.
Notifies claiming firm 1 that the allocation is cancelled.
Notifies claiming firm 2 of the new allocation.
Scenario 2: Executing Firm Amends Allocation - Updates Account or Quantity on the Allocation
In this scenario, the executing firm marked a trade for give-up and allocated it to a claiming firm:
The executing firm amends the allocation to reduce the quantity of the trade allocated to the claiming firm.Â
The clearing system:
Acknowledges the amendment to the executing firm.
Notifies the claiming firm that the allocation is amended.
Claiming Firm Amends an Allocation - Pre-Claim
In this scenario, the executing firm marked a trade for give-up and allocated it to a claiming firm:Â
The claiming firm amends the allocation to change an attribute of the trade, such as the carry account, origin, and CTI.Â
The clearing system:
Acknowledges the amendment to the claiming firm.
Executing Firm Cancels an Allocation - Pre-Claim
In this scenario, the executing firm marked a trade for give-up and allocated it to a claiming firm. The executing firm initiates a cancel before the allocation is claimed by the claiming firm:Â
The executing firm cancels the allocation.Â
The clearing system:Â
Acknowledges the cancellation to the executing firm.Â
Notifies the claiming firm that the allocation is cancelled.
Claiming Firm Amends an Allocation - Post-Claim
In this scenario, the claiming firm amends a previously allocated and claimed allocation:
The claiming firm amends the allocation. Examples of fields that can be amended include the carry account, origin, and CTI.
The clearing system acknowledges the amendment to the claiming firm. The clearing system does not notify the executing firm.
Executing Firm Cancels a Give-Up Group
Scenario 1: No Claimed Allocations
In this scenario, the executing firm allocated a trade to a claiming firm. The claiming firm has not claimed the allocation. The execution firm initiates the cancel of a give-up group:
The executing firm cancels the give-up group.
The clearing system:
Updates the group to a zero quantity and send a group summary with zero quantity confirming the group cancellation.
Each trade that was part of the group will be un-markeded from allocation.
Notifies the claiming firm that the previously submitted allocation (if any exists) is cancelled.
Notifies the executing firm that the previously submitted allocation (if any exists) is cancelled.
Trade updates are not sent to notify the executing firm that the trade is un-marked from allocation.
Scenario 2: Claimed Allocations Exist
In this scenario, the executing firm allocated a trade to a claiming firm. The claiming firm claimed the allocation. The execution firm initiates the cancel of the give-up group:
The executing firm cancels the give-up group.Â
The clearing system rejects the group cancellation message.
Executing Firm Un-Marks a Trade From Give-Up
Scenario 1: Trade is Not the Last Trade in the Group
In this scenario, trades have been added to a group and they have been allocated to a claiming firm. The trade is not the last trade in the group. The executing firm un-marks a trade:
The executing firm un-marks the trade from the give-up group.
The clearing system:
Acknowledges the trade amendment to the executing firm.
Sends a group summary to the executing firm showing a reduced group quantity.
Scenario 2: Trade is the Last Trade in the Group - with Claimed Allocations
In this scenario, a trade is added to a group and is allocated to a claiming firm. Some of the allocations have been claimed. The executing firm un-marks a trade. The trade is the last trade in the group:
The executing firm un-marks the trade from the give-up group.
The clearing system:
Acknowledges the trade amendment to the executing firm.
Sends a group summary to the executing firm with a Group Quantity of 0.
Scenario 3: Trade is the Last Trade in the Group - without Claimed Allocations
In this scenario, trades are added to a group and are allocated to a claiming firm. All the allocations are pending. The executing firm unmarks a trade. The trade is the last trade in the group:
The executing firm un-marks the trade from the give-up group.
The clearing system:
Acknowledges the trade amendment to the executing firm.
Sends a group summary to the executing firm showing the group is cancelled.
Sends allocation cancel notifications to the executing firm.Â
The number of cancel messages will depend on number of allocations that were created from the group.
Sends allocation cancel notifications to the claiming firms with the pending allocations.Â
Average Price Allocation
This section describes the conceptual flows for average pricing trades.
Executing Firm Marks Trades for Average Pricing
Scenario 1: Average Price Group Specified at Time of Marking
The executing firm marks a trade (trade amendment) for average pricing by specifying an average price group ID.
The clearing system:
Acknowledges the executing firm of the trade amendment that marked it for average pricing.
Creates a new group, if it does not exist, and sends a group summary creation notification to the executing firm, or
Alternatively, if the group already exists, updates the group and sends a group summary notification to the executing firm.
Scenario 2: Specifying an Average Price Group Later
The executing firm marks a trade (trade amendment) for average pricing without specifying a group.
The clearing system acknowledges the executing firm of the trade amendment and marks it for average pricing.
The executing firm updates the trade again by specifying an average price group.Â
The clearing system:
Acknowledges the executing firm of the group update.
If the group does not exist, creates a new group and sends a group summary creation notification to the executing firm, or
Alternatively, if the group already exists, the clearing system updates the group and sends a group summary notification to the executing firm.
Scenario 3: Marking a Trade for Another Average Price Group
In this scenario, the executing firm marked the trade to a group, and then marked the trade to a different group:Â
The executing firm marks a trade, changing the average price group.Â
The clearing system:
Acknowledges the executing firm of the trade amendment marking it to a new  average price group.Â
Sends a group summary update notification to the executing firm updating (reducing) the old group quantity.Â
Sends a group summary Create or Update notification to the executing firm for the new group.Â
The trade can be marked to a different average price group only if the group is not complete.
Executing Firm Completes an Average Price Group
In this scenario, the executing firm added all the trades to the average price group and completes the average price group:Â
The executing firm sends a group complete message to the clearing system.Â
The clearing system sends a group summary update notification with a status of complete.Â
When the group is complete, the executing firm can allocate.
Executing Firm Allocates an Average Price Group After Group Completion - Clearing System Splits Allocation
In this scenario, the executing firm marked trades for give-up. The executing firm completes the group, and then submits an allocation, which requires the clearing system to split the allocation into multiple allocations based on fee criteria, as defined by CME Clearing:Â
The executing system submits an allocation on a completed group.Â
The clearing system:
Sends the executing firm two acknowledgments; one for each split allocation.Â
Sends the claiming firm two notifications; one for each split allocation.
Example: The executing firm added a quantity of 10 Pit and 10 X-Pit to the group and completes the group. If the executing firm then submits an allocation of 15, two allocations are created, and the executing firm receives two messages for the single allocation request. Â
Executing Firm Amends Average Pricing Allocation
In this scenario, the executing firm amends an average pricing allocation by increasing the allocation quantity.
Scenario 1: The new allocated quantity results in an update to the existing allocation quantity. No split is required; the scenario is identical to give-up allocation.
Scenario 2:Â In this scenario, the clearing system amends the existing quantity, and additionally creates one or more allocations with the remaining quantity:
The clearing system amends the existing allocation to increase the allocated quantity, but not to the full quantity requested.
The clearing system creates one or more allocations to account for the remaining quantity. These allocations will have fee criteria that differ from the existing allocation.
Scenario 3:Â In this scenario, the clearing system creates one or more new allocations with the remaining quantity:
The clearing system creates one or more allocations to account for the entirety of the increase in quantity.Â
These scenarios are similar to the scenarios above and are not illustrated.Â
Executing Firm Un-Marks a Trade From an Average Price Group
In this scenario, the executing firm removes a trade from an average price group. The firm has the option to leave it marked for average pricing and specify a new group later.Â
The executing firm un-marks a trade, either from average pricing or from an average price group, by amending the trade.
The clearing system:
Acknowledges the executing firm of the trade amendment to unmark the trade from Average pricing.
Sends a group summary update notification to the executing firm.
Executing Firm Un-Completes an Average Price GroupÂ
Un-completing an average price group transitions the group’s status to incomplete and allows the executing firm to change the group by adding or removing trades. Un-completing a group cancels any pending allocations.
Scenario 1: Group has no Pending Allocations
In this scenario, the executing firm has added trades to an average price group and completed the average price group:Â
The executing firm un-completes the average price group.
The clearing system sends the executing firm a group summary, indicating the group is incomplete.
Scenario 2: Group has Pending Allocations
In this scenario, the executing firm added trades to an average price group and completed the average price group. The group has pending allocations:
The executing firm un-completes the average price group.
The clearing system:
Sends the executing firm a group summary showing the group as incomplete.
Notifies the claiming firm(s) about the cancellation of the pending allocation(s).
Acknowledges the allocation cancellation(s) to the executing firm.
Executing Firm Cancels an Average Price Group
In this scenario, the executing firm added trades to an average price group and the average price group has not yet been completed:
The executing firm cancels the average price group.
The clearing system sends the executing firm a group summary indicating that the group is cancelled.
Sub-Allocation
Once an allocation has been accepted, the claiming firm can sub-allocate the allocation. A sub-allocation request causes the clearing system to create a new give-up group for the allocation to the original claiming firm, or assign the claimed allocation to an existing give-up group.
If the sub-allocation is being average priced, an average price group is created and this behavior is similar to average pricing a trade. The average price group created due to a sub-allocation must be completed before allocation can begin. The message flow proceeds as if the claiming firm were the original executing firm:
the request is acknowledged
the claiming firm receives a group summary
the claiming firm(s) for the sub-allocation is notified.
Sub-Allocating Allocations
Scenario 1: Sub-allocating and specifying allocation instructions later
This scenario begins with the executing firm allocating a trade to claiming firm 1, which claims the allocation:
Claiming firm 1 marks the allocation for sub-allocation.
The clearing system sends a group summary for the newly created give-up group to claiming firm 1.
Claiming firm 1 submits allocation instructions, allocating the group to claiming firm 2.
The clearing system acknowledges the allocation to claiming firm 1 and notifies claiming firm 2 of the allocation.
Next, this scenario transitions to the claim workflow where the claiming firm 2 can claim or refuse the allocation.
Scenario 2: Sub-Allocating with Allocation Instructions
This scenario begins with the executing firm allocating a trade to claiming firm 1, which claims the allocation:
Claiming firm 1 marks the allocation for sub-allocation and includes allocation information.
The clearing system:
Sends a group summary for the newly created give-up group to claiming firm 1.
Acknowledges the claiming firm 1 of the new allocation.
Notifies the claiming firm 2 of the new allocation.
This scenario transitions to the claim workflow where the claiming firm 2 can claim or refuse the allocation.
Sub-Allocation and Average Pricing Allocations
This scenario begins with the executing firm allocating a trade to claiming firm 1, which claims the allocation:
Claiming firm 1 marks the allocation for sub-allocation, specifying an average price group.
The clearing system sends a group summary for the newly created average price group. Alternatively, if a group is already created, the allocation is added to the group.
Claiming firm 1 completes the average price group.
The clearing system confirms the claiming firm 1 with a group summary.
Claiming firm 1 submits allocation instructions, allocating the group to claiming firm 2.
The clearing system acknowledges the allocation to claiming firm 1 and notifies claiming firm 2 of the allocation.
This scenario transitions to the claim workflow where the claiming firm 2 can claim or refuse the allocation.
Sub-Allocation Modification and Cancellation
Sub-allocations behave similarly to normal allocations. Once a sub-allocation is submitted, it can be replaced or cancelled if the allocation is not claimed (for give up allocation) or the group is not complete (for average price allocation). However, unlike trades, sub-allocations for average pricing must always specify an average price group ID. They cannot be un-marked from an average pricing group and remain unassigned in the average pricing system.Â
Reversal of Accepted Allocations
Reversal is a process by which either firm (executing or claiming) can request to back out of an allocation. The reversal request goes through the claim work flow where the respondent is notified of the reversal request. When a reversal is complete, the allocation goes into a reversed
status. An initiator of the reversal can also cancel the request before it is claimed.Â
Claiming Firm Requests Reversal - Claimed by Executing Firm
In this scenario, the executing firm gave up a trade to a claiming firm and the claiming firm has claimed it. The claiming firm now requests to reverse the allocation:Â
The claiming firm requests a reversal.
The clearing system:
Acknowledges receipt of the request to the claiming firm
Notifies the executing firm of the reversal request.
The executing firm accepts the reversal.
The clearing system:
Acknowledges the acceptance of the reversal to the executing firm.
Notifies the claiming firm of the accepted reversal.
Claiming Firm Requests Reversal - Refused by Executing Firm
In this scenario, the executing firm gave up a trade to a claiming firm and the claiming firm has claimed it. The claiming firm now requests to reverse the allocation:
The claiming firm requests a reversal.
The clearing system:
Acknowledges receipt of the request to the claiming firm
Notifies the executing firm of the reversal request.
The executing firm refuses the reversal.
The clearing system:
Acknowledges the refusal of the reversal to the executing firm.
Notifies the claiming firm of the refused reversal.
Executing Firm Requests Reversal
This scenario is the same as (Claiming Firm Requests Reversal – Claimed by Executing Firm). In this case the reversal request is initiated by the executing firm instead of the claiming firm, and then claimed by the claiming firm.
Initiator of the Reversal Request Cancels the Request
In this scenario, the executing firm gave up a trade to a claiming firm, and the claiming firm has claimed it. The claiming firm now requests to reverse the allocation:
The claiming firm requests a cancel of the reversal.
The clearing system:
Acknowledges to the claiming firm that the reversal has been cancelled.
Notifies the executing firm of the reversal cancellation.
Cross-Exchange Give-Up Allocation
This section describes the interface for clearing firms to allocate trades to firms that trade in another exchange and claim trades allocated by a firm trading at another exchange. These are referred to as cross-exchange give-ups. Currently, this API only supports cross-exchange giveups
to exchanges that are part of the Mutual Offset Agreement. All references to a cross-exchange or a cross-exchange firm in this document imply SGX and SGX firms, respectively.Â
Cross-exchange give-up functions are almost identical to give-up allocations, except that one of the firms, either executing or claiming, belongs to another exchange. This section describes two basic cross-exchange allocation scenarios. Further scenarios are similar to give-up allocation. Differences between cross-exchange give-up and give-up allocation are illustrated in this section and in the API Submission and Usage Rules section. Average price allocation is not supported for cross-exchange allocation.Â
CME Executing Firm Allocates Trade to SGX Firm; SGX Firm Claims
In this scenario, a CME executing firm marks a trade for give-up specifying allocation instructions. The SGX claiming firm claims the allocation:Â
The CME executing firm either submits a new trade or amends a previously submitted trade with an indicator marking it for give-up and includes allocation information to an SGX firm.
The CME clearing system:
Acknowledges the trade submission or amendment.
Creates a give-up allocation group and notifies the executing firm.
Notifies the executing firm of the new allocation.
Notifies SGX clearing of the new allocation.
SGX clearing notifies the CME Clearing system of the claim.
The CME Clearing system notifies the executing firm of the claim.
SGX Executing Firm Allocates Trade to CME Firm; CME Firm ClaimsÂ
In this scenario, an SGX executing firm allocates a trade to a CME claiming firm. The CMEÂ claiming firm claims the allocation:Â
The SGX clearing system notifies the CME Clearing system of the allocation when an SGX firm allocates a trade to a CME firm.Â
The CME Clearing system notifies the CME claiming firm of a new allocation.Â
The CME claiming firm claims the allocation.Â
The CME Clearing system:
Notifies the SGX clearing system of the claim.
Confirms the claim to the CME claiming firm.
CME Executing Firm Cancels an Allocation - Pre-claim
The CME executing firm can cancel an allocation pre-claim.Â
If the SGX firm has claimed the allocation prior to receiving the cancel, the CME Clearing system responds as if the allocation were claimed and ignores the cancel.
If the SGX firm refused the allocation prior to receiving the cancel, the CME Clearing system responds as if the allocation were refused and ignores the cancel.
CME Claim Firm Reverses an Accepted Allocation
The CME firm may initiate a reversal of an accepted allocation, and the message flow is the same as for reversal of a give-up allocation.Â
How was your Client Systems Wiki Experience? Submit Feedback
Copyright © 2024 CME Group Inc. All rights reserved.