# Allocate trade

Divide a trade into post-trade allocations among multiple legal entities of the same organization. Available to broker users and sales dealer users. Customer organizations can be configured to allocate trades.

You must ensure that the allocated amounts equal the original trade amount.


Endpoint: POST /v2/trades/allocations
Version: 1.0.1
Security: SSO_TOKEN

## Request fields (application/json):

  - `id` (string, required)
    ID of the verified trade to divide into allocations.

  - `allocations` (array, required)

  - `allocations.referenceId` (string, required)
    Your reference ID for the allocation. Must be unique in the scope of the allocate request. Not validated for global uniqueness.

  - `allocations.allocationAmount` (number, required)
    Size of the allocation.

  - `allocations.side` (string, required)
    The direction of the allocation from the perspective of the  (case sensitive):
* BUY
* SELL

  - `allocations.customerAccount` (string, required)
    The customer account of the allocation.

  - `allocations.note` (string)
    Any notes on the allocation. These notes are sent via STP if the trade is eligible for STP (stp=true).

## Response 200 fields (application/json):

  - `originalTradeId` (string)
    ID of the original trade that was amended.

  - `trades` (array)

  - `trades.referenceId` (string)
    Your reference ID for the allocation.

  - `trades.tradeId` (string)
    ID of the allocation.