--- title: "Modelling a reverse stock split (SPLR)" slug: "modelling-a-reverse-stock-split-splr" updated: 2026-11-18T12:11:40Z published: 2026-11-18T12:11:40Z canonical: "support.lusid.com/modelling-a-reverse-stock-split-splr" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.lusid.com/llms.txt > Use this file to discover all available pages before exploring further. # Modelling a reverse stock split (SPLR) 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](/v1/docs/understanding-dedicated-corporate-action-events). Note the following: - `ReverseStockSplitEvent` is valid for instruments of type `Equity`, `SimpleInstrument`, `ContractForDifference`, `EquityOption` and `ExchangeTradedOption`. - The holding stays in the same instrument; only its number of units falls. `ReverseStockSplitEvent` cannot move a holding to a new instrument. - The entitlement date is the `exDate` specified when you load `ReverseStockSplitEvent`. - 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](/v1/docs/modelling-a-reverse-stock-split-splr#handling-fractional-units). - 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 is `paymentDate`. The cash-in-lieu and buy-up transactions are dated `paymentDate`. ## 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](/v1/docs/how-do-i-upload-corporate-actions-to-a-corporate-action-source). For more information on fields, see the [ReverseStockSplitEvent](https://www.lusid.com/docs/api/lusid/schemas/ReverseStockSplitEvent/) schema. Where set, the following date validation rules apply: `exDate ≤ paymentDate` > **Note**: In `unitsRatio`, `input` must be greater than `output`. 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? | | --- | --- | --- | --- | | `Mandatory` | 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 | | --- | --- | | `Floor` (the default) | Rounds down to a whole unit. The holder receives cash in lieu for the fraction. | | `Ceiling` | Rounds up to a whole unit at no cost. No cash. | | `RoundHalfUp`, `RoundHalfDown`, `BankerRounding` | Rounds to the nearest whole unit, treating an exact half as the name suggests (`BankerRounding` rounds a half to the nearest even unit). Cash in lieu if rounded down; none if rounded up. | | `RoundToDecimalPlaces` | Rounds to the number of decimal places in `fractionalUnitsDecimalPlaces`. Cash in lieu for any remainder rounded away. | | `BuyUp` | Rounds up to a whole unit, and the holder pays for the extra fraction at `fractionalUnitsCashPrice`. | ## 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 | | --- | --- | --- | | [ReverseStockSplitUnitReduction](/v1/docs/recommended-transaction-types-for-corporate-action-events#reversestocksplitunitreduction-transaction-type) | Always | Removes units from the holding without changing its total cost. | | [ReverseStockSplitCashInLieu](/v1/docs/recommended-transaction-types-for-corporate-action-events#reversestocksplitcashinlieu-transaction-type) | A fraction is rounded away, and the event sets `fractionalUnitsCashPrice` and `fractionalUnitsCashCurrency` | 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. | | [ReverseStockSplitBuyUp](/v1/docs/recommended-transaction-types-for-corporate-action-events#reversestocksplitbuyup-transaction-type) | The event sets `fractionalUnitsRoundingConvention` to `BuyUp` | 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 `DirectAdjustment` movement 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 `fractionalUnitsCashCurrency` for 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. ```json [  {    "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. ```json [  {    "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.