# An Indicative Quote

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

What an order would trade at now, and what it would cost or pay after your tenant's fee.

## Overview

- Give `tokenAmount` (tokens) or `notionalValue` (US dollars), exactly one, as a decimal with at most 18 digits after the point. `paymentToken` is what a buy is paid in, or a sale paid out in: on chain `1` `USDC` (the default) or `USDon`, on chain `56` `USDT` (the default) or `USDon`; a portfolio in `USDC` or `USDT` only.
- `value` = `tokenAmount` × `price`, rounded down; `paymentAmount` is what a buy is charged (rounded up to the payment token's decimals) or a sale pays (rounded down); `fee` is your tenant's fee, in basis points and in the payment token (rounded up); `total` is a buy's payment plus the fee, or a sale's payment less it.
- Indicative: nothing is reserved, no limit is used, nothing is stored, and no eligibility, wallet, trading hours or limit is checked — a [binding quote](https://docs.aureahub.com/docs/tok-quote-create.md) may differ. 60 a minute.
- 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.`). |
| 409 | TOKENIZED_ASSETS_NOT_SUPPORTED_FOR_ASSET | An asset the issuer issues and redeems directly, not traded with quotes (`Quotes are not available for this asset yet.`). |
| 409 | TOKENIZED_ASSETS_MULTIPLIER_UPDATE | Such an asset within its multiplier's adjustment window (`details.until`). |
| 400 | TOKENIZED_ASSETS_QUOTE_NOT_SUPPORTED | The settlement token or the yield token: not traded with quotes (`This asset is not traded with quotes.`). |
| 400 | TOKENIZED_ASSETS_CHAIN_UNSUPPORTED | The asset has no token on `chainId` (`This asset has no token on this chain.`). |
| 400 | TOKENIZED_ASSETS_PAYMENT_TOKEN_UNSUPPORTED | `paymentToken` is not taken for this asset on this chain (`This asset is paid in USDC or USDon on this chain.`, with `details.accepted`). |
| 400 | TOKENIZED_ASSETS_INVALID_AMOUNT | `Give exactly one of tokenAmount and notionalValue`; `an amount is a decimal number written with digits and at most one point`; `an amount is too large`; `an amount has at most 18 digits after the point`; `The amount must be above zero`. |
| 409 | TOKENIZED_ASSETS_… | The market says no ([Provider Errors](https://docs.aureahub.com/docs/guide-tokenized-assets.md)): `MARKET_CLOSED`, `MARKET_PAUSED`, `ASSET_PAUSED`, `ASSET_LIMITED`, `ASSET_CLOSED_FOR_SESSION`, `ASSET_SELL_ONLY`, `INSUFFICIENT_LIQUIDITY`, `SESSION_LIMIT_REACHED`, `AFTER_HOURS_LIMIT_REACHED`, `CHAIN_PAUSED`; `400` `…_ORDER_TOO_SMALL`, `…_INVALID_REQUEST`. |
| 503 | TOKENIZED_ASSETS_PROVIDER_… | The market could not be read or answered unexpectedly ([Provider Errors](https://docs.aureahub.com/docs/guide-tokenized-assets.md)); `TOKENIZED_ASSETS_PROVIDER_READ_ONLY_KEY` when your tenant's provider access can read but not quote (`Binding quotes are not available for this tenant at the moment.`). |

## Endpoint

### `POST /v1/tokenized-assets/quotes/indicative`

Authentication: bearer token required.

What an order would trade at now, after the tenant's fee.

**Request body**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `isTestnet` | boolean | no | `true` for the test environment; `false` (the default) for production. |
| `symbol` | string | yes | The token's symbol, as its contract names it (case matters). Pattern `^[A-Za-z0-9.-]{1,32}$`. |
| `chainId` | number | yes | The chain: 1 (Ethereum) or 56 (BNB Chain). One of `1`, `56`. |
| `side` | string | yes | One of `buy`, `sell`. |
| `tokenAmount` | string | no | How many tokens, as a decimal of at most 18 digits after the point. Give this or notionalValue. At most 80 characters. |
| `notionalValue` | string | no | How many US dollars, as a decimal of at most 18 digits after the point. Give this or tokenAmount. At most 80 characters. |
| `paymentToken` | string | no | What the buy is paid in, or the sale paid out in: on chain 1 USDC (the default) or USDon, on chain 56 USDT (the default) or USDon; a portfolio in USDC or USDT only. One of `USDC`, `USDT`, `USDon`. |

**Responses**

`200` OK

```json
{
  "symbol": "AAPLon",
  "chainId": 1,
  "side": "buy",
  "tokenAmount": "2",
  "price": "254.31",
  "value": "508.62",
  "paymentToken": "USDC",
  "paymentAmount": "508.62",
  "fee": {
    "bps": 50,
    "amount": "2.5431"
  },
  "total": "511.1631",
  "isTestnet": false,
  "binding": false
}
```

`400` Amount

```json
{
  "statusCode": 400,
  "error": "BadRequestError",
  "message": "Give exactly one of tokenAmount and notionalValue",
  "details": {
    "code": "TOKENIZED_ASSETS_INVALID_AMOUNT"
  }
}
```

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

---

Web version: https://docs.aureahub.com/#tok-quote-indicative