# An Asset's Candles

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

Open, high, low and close of an asset, and of its underlying instrument, for an interval over a range.

## Overview

- `interval` is the candles' size, `range` how far back: `1day` is the last 24 hours, `all` the whole history. Both are required.
- `candles` are the token's; `underlying.candles` its instrument's, or `underlying: null` without one. Prices are US dollars, as decimal strings.
- 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}/candles`

Authentication: bearer token required.

Open, high, low and close of an asset over a range.

**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. |
| `interval` | string | yes | The candles' size. One of `1min`, `5min`, `15min`, `1hour`, `4hour`, `12hour`, `1day`. |
| `range` | string | yes | How far back: 1day is the last 24 hours, all the whole history. One of `1day`, `1month`, `3month`, `6month`, `1year`, `all`. |

**Responses**

`200` OK

```json
{
  "isTestnet": false,
  "symbol": "AAPLon",
  "interval": "1day",
  "range": "1month",
  "candles": [
    {
      "timestamp": "2026-10-06T00:00:00.000Z",
      "open": "251.02",
      "high": "255.40",
      "low": "250.11",
      "close": "252.44"
    }
  ],
  "underlying": {
    "ticker": "AAPL",
    "candles": [
      {
        "timestamp": "2026-10-06T00:00:00.000Z",
        "open": "251.00",
        "high": "255.38",
        "low": "250.10",
        "close": "252.41"
      }
    ]
  }
}
```

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

---

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