---
title: "Get Shares Multiplier History for an Asset"
method: GET
path: "/v1/assets/{symbol}/shares-multiplier"
tags: ["Assets"]
---

# Get Shares Multiplier History for an Asset

`GET /v1/assets/{symbol}/shares-multiplier`

This endpoint retrieves the shares multiplier history for a specific asset. Note that some asset events do not result in the shares multiplier value changing. This endpoint will show the earliest timestamp for each value change.

The `range` parameter determines how far back historically to look for shares multiplier data. See below for valid range values.

Valid `range` values:
- 1day
- 1month
- 3month
- 6month
- 1year
- all *(all historical data)*

For caching details on this endpoint, please see: [Endpoint Caching](https://docs.ondo.finance/api-reference/endpoint-caching).

## Path parameters

- `symbol` string, required

## Query parameters

- `range` '1day' | '1month' | '3month' | '6month' | '1year' | 'all', required — The look back range for historical data. (Note that '1day' will return a rolling 24-hour period of data and 'all' will return all historical data.)

## Response `200`

OK

- SharesMultiplierResponse
  - `history` SharesMultiplierDataPoint[], required
    - `sharesMultiplier` string, required — The number of shares each token is equivalent to, represented as a string-encoded decimal with up to 18 digits after the decimal point.
    - `changeTimestamp` number, required — The Unix timestamp in milliseconds when this `sharesMultiplier` value was first set.
  - `timestamp` number, required — The Unix timestamp in milliseconds when the data point was recorded.

## Other responses

- `400` — One of the request parameters is invalid. Please see the returned message and documentation for details.
- `401` — Missing or invalid API key.
- `404` — The provided asset symbol does not exist and cannot be found. Please see the returned message and documentation for details.
- `429` — The account has exceeded its rate limits. Please see the returned message and documentation for details.
- `500` — An internal server error occurred. Please see the returned message and documentation for details.

---

[API](https://skmtc.net/ondo/apis/gm-backend-api.md) · [All operations](https://skmtc.net/ondo/apis/gm-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ondo/gm-backend-api/versions/12953a4908b2/schema)