Skip to main content
New to the shares multiplier concept? This page is a technical and operational guide for partners integrating with the API. For the conceptual explanation and worked dividend example, start with Token & Quote Pricing. For the underlying corporate-action mechanics that trigger multiplier changes (e.g., dividends, ex-dates, pauses, splits), see Corporate Actions.

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.
Using the multiplier this way avoids user confusion about why the token’s price differs from the price of the underlying asset. The token price and the share price diverge over time by design, and the multiplier is what reconciles the two.

3. Sourcing the multiplier

Fetch the multiplier from Ondo’s API on your server:
Related reference: Get Shares Multiplier History for an Asset

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.
Use the change timestamp, not the wall clock. The API returns a change timestamp for each record. Use it to determine when a corporate action was actually applied, rather than inferring the timing from a fixed schedule. Distinguish the settlement token from what users see. Ondo’s settlement token (e.g., ACMEon for ACME) is the actual custody and settlement asset under the hood. What a partner shows its users is a separate, more flexible decision:
  • 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.