Modelling a reverse stock split (SPLR)

Prev Next

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:

  • 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.

  • 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.

For more information on fields, see the 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

Always

Removes units from the holding without changing its total cost.

ReverseStockSplitCashInLieu

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

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.

[
  {
    "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.