# An Asset's Status

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

Whether an asset's trading is paused or limited, with its pauses.

## Overview

- From the market data feed: `paused`, `limited` and the `events` as [Paused and Limited Assets](https://docs.aureahub.com/docs/tok-market-asset-statuses.md) gives them (`source: "feed"`).
- When the feed cannot be read, the pause the token's contracts enforce, read on chain (`source: "chain"`): `buyPaused`, `sellPaused`, `tokenPaused` (no transfer moves it); `limited` is then `null`. On mainnet only: in the test environment the feed's failure is answered.
- For an asset without a market data feed: `paused` while the issuer halts its market or instant orders, and around each change of its multiplier (from 15 minutes before to 15 minutes after) — each such window, now or coming, an event with `code` `TOKENIZED_ASSETS_ASSET_PAUSED` and `multiplierUpdate: true`; `limited`, `buyPaused`, `sellPaused` and `tokenPaused` are `null`.
- Every asset your tenant offers; kept up to a minute (15 seconds without a feed).
- 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`). |
| 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}/status`

Authentication: bearer token required.

Whether the asset's trading is paused or limited.

**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
{
  "symbol": "AAPLon",
  "paused": false,
  "limited": false,
  "buyPaused": null,
  "sellPaused": null,
  "tokenPaused": null,
  "events": [],
  "source": "feed",
  "isTestnet": false
}
```

`200` Read on Chain

```json
{
  "symbol": "AAPLon",
  "paused": true,
  "limited": null,
  "buyPaused": true,
  "sellPaused": false,
  "tokenPaused": false,
  "events": [],
  "source": "chain",
  "isTestnet": false
}
```

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

---

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