1. What the shares multiplier is
Ondo Stocks are total-return trackers: each token reflects the underlying stock’s price plus reinvested dividends and other cash flows. Because dividends are used to buy more of the underlying shares on the token’s behalf, one token may represent a growing number of shares over time rather than a fixed 1:1. The shares multiplier is the number of shares represented per token. Applying it lets you scale a raw token balance into a share-equivalent balance that matches what a user would hold if they owned the stock directly, while still capturing reinvested dividends and other corporate actions. For the full worked example of how a dividend moves the multiplier (e.g., from 1.0 to 1.05), see Token & Quote Pricing.2. How to apply it
The Ondo token is the settlement and custody asset. It is what actually moves and settles under the hood. The shares multiplier lets you translate that raw token balance into a share-equivalent balance wherever it’s useful to show users a number they recognize. It’s up to an integrator to decide where applying the multiplier makes the most sense for their business: at the UI, at the API layer, in reporting, in statements, or anywhere else holdings are presented to users. The right layer depends on your product and how your users interact with balances.- Share-equivalent balance = raw balance × shares multiplier
- Share-equivalent price = raw price ÷ shares multiplier
- For example, with a multiplier of 1.05, 100 raw ACMEon tokens display as 105 ACME shares, and a raw price of $105 displays as $100/share. Either way, the position is worth $10,500.
3. Sourcing the multiplier
Fetch the multiplier from Ondo’s API on your server:4. Best practices for integration
Pause activity during multiplier changes. Stop trading, deposits, withdrawals, and any other applicable actions on the affected Ondo Stock for the duration of a multiplier change. The schedule of multiplier changes is published on the API and the Ondo Status page, and the change window is 5 minutes. Validate the size of each multiplier move. Not every multiplier change should be treated the same way:- Auto-accept moves of up to 5%, consistent with routine dividend reinvestment.
- Treat stock splits as a special case requiring manual review. A split can produce a large, legitimate multiplier change, and large changes should require human verification before unpausing rather than being auto-applied like a routine dividend update.
- Describe ACMEon as the settlement token. It’s fine to tell users, plainly, that Ondo tokens are what settles their trade under the hood.
- Show normalized, share-equivalent values in your interface, so users see numbers that feel like they’re trading the actual security rather than a drifting token. For example: 1 ACMEon = 1.1 ACME. Show the user “1.1 ACME,” not “1 ACMEon.”
- You may drop the “on” suffix in your UI and simply show the ticker as ACME. If you do, pair it with a small Ondo logo next to the ticker so it’s clear to users that the position is powered by Ondo and settled in Ondo tokens under the hood, even though the number and ticker they see match the underlying security.
Related pages
- Token & Quote Pricing: conceptual background, total-return tracker mechanics, worked dividend example, display scaling
- Corporate Actions: what triggers a multiplier change (dividends, ex-dates, pauses, splits)
- Get Shares Multiplier History for an Asset: API reference

