# The Yield Token's Price

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

The yield-bearing dollar token's price, read on chain.

## Overview

- `priceUsd`: the price the token is subscribed and redeemed at, as its manager reads it from its oracle; `rebasingPriceUsd`: the price its rebasing form's balances follow; `sharesPerToken`: the rebasing form's shares per token; `blockNumber`: the block read. On chain `1`; read on every call.
- For a tenant that offers the yield token (`yield_token`); in the test environment `409` `TOKENIZED_ASSETS_EXECUTION_UNAVAILABLE` today.
- 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 the yield token (`details.symbol`). |
| 409 | TOKENIZED_ASSETS_EXECUTION_UNAVAILABLE | `This operation is not available in this environment and chain.` — in the test environment, always today. |
| 503 | TOKENIZED_ASSETS_CHAIN_UNAVAILABLE | `The chain cannot be reached for this tenant at the moment.` |
| 409 | TOKENIZED_ASSETS_PRICE_OUT_OF_BOUNDS | A price read on chain is not above zero. |

## Endpoint

### `GET /v1/tokenized-assets/yield/price`

Authentication: bearer token required.

The yield token's price, read on chain.

**Query parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `isTestnet` | string | no | `true`: the test environment; `false` (the default): production. |

**Responses**

`200` OK

```json
{
  "isTestnet": false,
  "chainId": 1,
  "priceUsd": "1.130912",
  "rebasingPriceUsd": "1",
  "sharesPerToken": 10000,
  "blockNumber": "23541872"
}
```

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

---

Web version: https://docs.aureahub.com/#tok-yield-price