Skip to content

Splits and dividends

Stock token issuers pass corporate actions on in one of two ways. Every xStocks, Ondo and Backpack token on Solana is a Token-2022 mint with the scaled UI amount extension: the balance a wallet displays is the raw balance times the mint’s multiplier. xStocks and Ondo change the multiplier to pass on a reinvested dividend or a split, so their raw balances never change. Backpack keeps its multiplier and adjusts balances instead, minting or burning holders’ tokens in proportion.

Sagitta prices a stock token per raw base unit: Jupiter’s usdPricePrescaled, the displayed price times the multiplier in force. That is the value one raw unit of the token carries, and it moves with the stock itself:

  • A split passed on through the multiplier multiplies the displayed balance and divides the displayed price, and leaves the price per base unit where it was. A 4:1 split shows as a 75% drop in the displayed price and as no move at all in a market. A split applied by adjusting balances moves the price per base unit too: one of 3:2 or more is marked as a step (below), and a smaller one pays like any move.
  • A reinvested dividend passed on through the multiplier raises it as the stock goes ex-dividend, so the price per base unit carries through the drop. What can remain is a small residual: the share an issuer keeps back for tax, or a gap between when the multiplier changes and when the market opens ex-dividend. A dividend reinvested by adjusting balances leaves the price per base unit to fall with the stock, and that fall pays like any move. These are correct prices on a public schedule, and they are part of the game.

Readings are relayed prices: Sagitta’s price signers sign Jupiter’s price per base unit at a stated slot, and every posted reading is listed with its signers by GET /api/readings (see Relayed prices).

A step is a reading across a corporate action that the price per base unit did not absorb. The price signers mark such a reading with a signed flag when the issuer’s own data on chain shows the action:

  • a change of the multiplier as large as a step;
  • a split of 3:2 or more, or a reverse split as large, applied by scaling in proportion the balances that hold most of the token’s supply.

A narrower split, such as 5:4, or a change of balances that leaves most of the supply as it was, is not marked, and its reading pays its whole move. On a marked reading alone a move of 2,000 ticks or more (a factor of 1.2214, +22.1% or −18.1%) applies without paying: it counts as a reading and fills the tickets waiting on it, but moves nothing between the pots. Below that size it pays like any move.

An unmarked reading always pays its whole move. Readings are posted when tickets need them, so a quiet token’s next reading carries every move since the last one, and that merged move pays in full.

Sagitta’s watchdog checks a marked reading against the issuer’s data by the same rule (see Relayed prices).

An issuer may pause its token briefly around a corporate action. While no fresh price posts, the token’s markets hold still and their tickets wait. A long pause only delays the waiting tickets: if the oldest of them still has no reading 7 days after its commit, the market freezes at its last price (see Refunds).