You can model a reverse stock split, where a company consolidates its shares into fewer shares with a proportionally higher price, as a corporate action of type ReverseStockSplitEvent in LUSID. See all supported corporate actions.
Note the following:
ReverseStockSplitEventis valid for instruments of typeEquity,SimpleInstrument,ContractForDifference,EquityOptionandExchangeTradedOption.The holding stays in the same instrument; only its number of units falls.
ReverseStockSplitEventcannot move a holding to a new instrument.The entitlement date is the
exDatespecified when you loadReverseStockSplitEvent.The units removed are calculated from the total number of instrument units held on the entitlement date, settled and unsettled: (1 −
output÷input) × units held.By default the holder keeps whole units only. The fraction of a unit is removed too, and paid in cash if you specify cash-in-lieu terms. You can choose a different rounding convention.
In a portfolio that tracks tax lots, LUSID reduces and rounds each lot separately, so each lot can generate its own cash-in-lieu transaction.
The transaction date of the automatically-generated unit reduction is
exDate, and the settlement date ispaymentDate. The cash-in-lieu and buy-up transactions are datedpaymentDate.
Loading ReverseStockSplitEvent
You must load ReverseStockSplitEvent into a corporate action source registered with one or more portfolios. The event then impacts every registered portfolio with a holding in the underlying instrument. See how to do this.
For more information on fields, see the ReverseStockSplitEvent schema. Where set, the following date validation rules apply:exDate ≤ paymentDate
Note: In
unitsRatio,inputmust be greater thanoutput. For example, a 10-for-1 consolidation is{"input": 10, "output": 1}.
Only one participation type is valid, and there are no elections:
Participation type | Election(s) | Election choices | Further action required? |
|---|---|---|---|
| N/A | N/A | ❌ No. The reverse split always occurs automatically. |
Handling fractional units
A reverse split often leaves a holder entitled to a fraction of a unit. To pay cash for fractions, set fractionalUnitsCashPrice (the price per post-split unit) and fractionalUnitsCashCurrency. If either is missing, LUSID still rounds the holding but generates no cash.
To change how the fraction is rounded, set fractionalUnitsRoundingConvention. This applies to the units the holder keeps, and requires fractionalUnitsCashPrice:
Rounding convention | Units kept and cash |
|---|---|
| Rounds down to a whole unit. The holder receives cash in lieu for the fraction. |
| Rounds up to a whole unit at no cost. No cash. |
| Rounds to the nearest whole unit, treating an exact half as the name suggests ( |
| Rounds to the number of decimal places in |
| Rounds up to a whole unit, and the holder pays for the extra fraction at |
Configuring the economic impact
You must create some or all of the following transaction types to handle automatically-generated output transactions. They are not provided for you.
Transaction type (click for our recommendation) | Implement the transaction type if… | Intended economic impact |
|---|---|---|
Always | Removes units from the holding without changing its total cost. | |
A fraction is rounded away, and the event sets | Credits cash for the fraction and reduces the holding's cost by the same amount. The fraction's units have already been removed by the unit reduction. | |
The event sets | Debits cash for the extra fraction and adds the same amount to the holding's cost. The extra fraction is already kept by the unit reduction. |
Note: The unit reduction already rounds the holding. If your cash-in-lieu or buy-up transaction type also moves units, the fraction is removed or added twice.
You can give a transaction type any economic impact you like. Our recommendation:
Removes units with the
DirectAdjustmentmovement option, so the total cost stays with the remaining units and the cost per unit rises. Without this option, LUSID treats the removed units as a disposal at zero proceeds and books their cost as a realised loss.Creates or updates a cash holding in the
fractionalUnitsCashCurrencyfor any cash in lieu or buy-up.Books no
ProfitAndLoss/Realised/*amounts on the reverse split.
Reference examples
A reverse split with cash in lieu
A company consolidates every three shares into one. Fractions are paid in cash at 30.00 GBP per post-split share.
[
{
"instrumentEventId": "SPLR-ACMECORP-2026",
"instrumentIdentifiers": {
"Instrument/default/ClientInternal": "ACMECORP-EQ"
},
"description": "Reverse stock split - Acme Corp, 1 new share for every 3 held",
"participationType": "Mandatory",
"instrumentEvent": {
"instrumentEventType": "ReverseStockSplitEvent",
"exDate": "2026-09-01T00:00:00.0000000+00:00",
"paymentDate": "2026-09-08T00:00:00.0000000+00:00",
"unitsRatio": { "input": 3, "output": 1 },
"fractionalUnitsCashPrice": 30.00,
"fractionalUnitsCashCurrency": "GBP"
}
}
]A portfolio holding 100 shares at a cost of 1,000.00 GBP is entitled to 33.333 shares. LUSID generates a unit reduction of 67 shares on 1 September 2026, leaving 33, and a cash-in-lieu transaction of 10.00 GBP (0.333 × 30.00) on 8 September 2026. With our recommended transaction types, the holding ends at 33 shares with a cost of 990.00 GBP, and nothing is realised.
A reverse split with buy-up
The same terms, but the holder buys the extra fraction needed to round up to a whole share.
[
{
"instrumentEventId": "SPLR-ACMECORP-2026-BUYUP",
"instrumentIdentifiers": {
"Instrument/default/ClientInternal": "ACMECORP-EQ"
},
"description": "Reverse stock split - Acme Corp, 1 for 3, fractions bought up",
"participationType": "Mandatory",
"instrumentEvent": {
"instrumentEventType": "ReverseStockSplitEvent",
"exDate": "2026-09-01T00:00:00.0000000+00:00",
"paymentDate": "2026-09-08T00:00:00.0000000+00:00",
"unitsRatio": { "input": 3, "output": 1 },
"fractionalUnitsCashPrice": 30.00,
"fractionalUnitsCashCurrency": "GBP",
"fractionalUnitsRoundingConvention": "BuyUp"
}
}
]The same portfolio receives a unit reduction of 66 shares, leaving 34, and a buy-up transaction of 20.00 GBP (0.667 × 30.00). The holding ends at 34 shares with a cost of 1,020.00 GBP, and nothing is realised.