# An Asset's Shares Multiplier

> Coming soon, upon request — this feature is turned on for your tenant by the Aurea team. [Contact us](https://www.aureahub.com/contact)

How many shares of the underlying one token stands for now, and how that changed.

## Overview

- `current` is the multiplier now; `history` each change, oldest first, with its `reason`: `cash_dividend`, `stock_dividend`, `stock_split`, `spinoff` or `other`. `range` is how far back the history goes (default `1year`).
- When the market data cannot be read, the current value read on chain, without history: `source` is then `chain`, and `corporateActionPause` says whether a corporate action's pause is on (`null` from the feed).
- For an asset without a market data feed: the history of its first chain, whole whatever `range`, its reasons `cash_dividend`, `stock_split` or `other`, and `corporateActionPause: null` — every chain's in [Multipliers per Chain](https://docs.aureahub.com/docs/tok-asset-multipliers.md); one with no token on a chain served here answers `409` `TOKENIZED_ASSETS_NOT_SUPPORTED_FOR_ASSET` (`This asset has no token on a chain served here.`).
- User token and the tenant signature ([Calling the Routes](https://docs.aureahub.com/docs/guide-tokenized-assets.md)); every tenant role may call it.

## Errors

Besides [the answers every tokenized assets route can give](https://docs.aureahub.com/docs/guide-tokenized-assets.md) (no valid token or signature, the module not set up or not switched on, a field that does not fit):

| Status | details.code | When |
| --- | --- | --- |
| 404 | TOKENIZED_ASSETS_ASSET_NOT_OFFERED | Your tenant does not offer this symbol in this environment (`This tenant does not offer this asset.`, with `details.symbol`). |
| 409 | TOKENIZED_ASSETS_NOT_SUPPORTED_FOR_ASSET | The route has no data for this asset (`This is not available for this asset.`). |
| 503 | TOKENIZED_ASSETS_PROVIDER_… | The market data could not be read ([Provider Errors](https://docs.aureahub.com/docs/guide-tokenized-assets.md)): `…_UNAVAILABLE`, `…_RATE_LIMITED`, `…_AUTHENTICATION_FAILED`, `…_UNEXPECTED_RESPONSE` or `…_ERROR`. |

## Endpoint

### `GET /v1/tokenized-assets/assets/{symbol}/multiplier`

Authentication: bearer token required.

How many shares of the underlying one token stands for, and its history.

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `symbol` | string | yes | The token's symbol, as its contract names it (case matters). Pattern `^[A-Za-z0-9.-]{1,32}$`. |

**Query parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `isTestnet` | string | no | `true`: the test environment; `false` (the default): production. |
| `range` | string | no | How far back the history goes. One of `1day`, `1month`, `3month`, `6month`, `1year`, `all`. Default `1year`. |

**Responses**

`200` OK

```json
{
  "isTestnet": false,
  "symbol": "AAPLon",
  "current": "1.002931",
  "corporateActionPause": null,
  "history": [
    { "multiplier": "1.001894", "changedAt": "2026-05-16T00:00:00.000Z", "reason": "cash_dividend" },
    { "multiplier": "1.002931", "changedAt": "2026-08-15T00:00:00.000Z", "reason": "cash_dividend" }
  ],
  "source": "feed"
}
```

[Contact us for details](https://www.aureahub.com/contact).

---

Web version: https://docs.aureahub.com/#tok-asset-multiplier