# An Asset's Market Data

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

An asset's price and change, its last 24 hours, its holders, its shares multiplier and sessions, and its underlying instrument's fundamentals.

## Overview

- `multiplier` is how many shares of the underlying one token stands for (dividends reinvested); `tradableSessions` the sessions it trades in.
- `underlying` holds the instrument's price, 52-week high and low, volumes, shares outstanding and market capitalisation; it is `null` for a token of several assets, whose symbols are in `constituents`.
- Kept up to a minute. Served for the assets with a market data feed: for any other asset your tenant offers, `409` `TOKENIZED_ASSETS_NOT_SUPPORTED_FOR_ASSET`.
- 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}/market`

Authentication: bearer token required.

An asset's market data and its underlying's fundamentals.

**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. |

**Responses**

`200` OK

```json
{
  "isTestnet": false,
  "symbol": "AAPLon",
  "price": "254.31",
  "change24h": "1.87",
  "changePct24h": "0.74",
  "history24h": [
    { "timestamp": "2026-10-06T15:00:00.000Z", "price": "252.44" }
  ],
  "holders": 4182,
  "multiplier": "1.002931",
  "tradableSessions": ["premarket", "regular", "postmarket", "overnight"],
  "underlying": {
    "ticker": "AAPL",
    "name": "Apple Inc.",
    "price": "254.28",
    "high52w": "260.10",
    "low52w": "169.21",
    "volume": "48211930",
    "averageVolume": "53018422",
    "sharesOutstanding": "14840390000",
    "marketCap": "3773618000000"
  },
  "constituents": [],
  "timestamp": "2026-10-07T15:02:10.000Z"
}
```

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

---

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