# Holding

Source: https://docs.settlemint.com/docs/console/my-assets/holding
Open a holding to read its position, terms and eligibility, start a transfer, redeem, claim or conversion, and follow the balance over time.

A holding page shows one position of the participant selected in **Working as**, you or the participant you act for: what it is worth, what is available, the asset's terms and eligibility, and the operations the holder can start on it. Reading it changes nothing. An operation from the header changes the balance once its block is indexed. You reach it from a row on [Portfolio](https://docs.settlemint.com/docs/console/my-assets/portfolio).

![Holding page with the header actions, the key figures strip and the Overview tab](https://docs.settlemint.com/docs/screenshots/console-portfolio-holding.light.en.webp)

[Screenshot] A holding page with the header actions, the key figures strip and the Overview tab beside its side column.

The header offers the primary action and the "Actions" menu, a strip of key figures follows, and the "Overview" tab sits beside a side column with "Position", "Terms", "Eligibility", "Documents" and "Technical details".

## Before you start [#before-you-start]

- Confirm the participant you work as and the network. The page reads one network's wallets. While you work as someone else, it reads that participant's wallets only, as [Portfolio](https://docs.settlemint.com/docs/console/my-assets/portfolio) does.
- Each operation in the header asks for your PIN or an authenticator code and submits as soon as you confirm. This page cannot cancel a submitted operation.
- [Portfolio](https://docs.settlemint.com/docs/console/my-assets/portfolio#start-a-holder-operation) lists the condition of each holder operation.
- A holder of the asset's **Custodian** role can freeze all or part of a balance, move tokens out of a wallet with a forced transfer, and move a lost wallet's balance to a replacement wallet, without the holder signing.

## Steps [#steps]

### Open the holding [#open-the-holding]

Select a holding row to open its page. The breadcrumb reads "Wealth", "Portfolio" and the asset name, and the **Portfolio** crumb takes you back to the holdings list.

### Read the figures and tabs [#read-the-figures-and-tabs]

A strip of key figures follows the header: "Position value", "Principal" or "Balance", "Next coupon" or "Next interest", "Ready to claim", "Available", "Frozen", "Locked" with its next unlock under it, and "Value", as they apply to the asset. A holding without a reliable market price shows a dash and "No market price" in "Position value", "Principal" and "Value", never the token quantity. A **Position value** or "Principal" with a known face value shows that face value instead, marked "At face value · no market price".

When a coupon period becomes claimable, it moves from "Next coupon" and "Next payments" to **Ready to claim**. Under the figures, at most one finding states what most affects the holding, such as "You can't receive more" followed by the asset's symbol, "This bond has matured", a frozen amount or "Matures on" followed by the date.

The page has the tabs "Overview", "Activity" and "Documents", with **Activity** only when the asset keeps a balance history, and its side column shows "Position", "Terms", "Eligibility", "Documents" and "Technical details".

When the asset keeps a balance history, **Balance over time** charts your balance after each recorded change. "Activity" lists each change with its amount and the balance after it. A change made by a corporate action names that action, such as "Stock split 3-for-2", "Reverse split 1-for-3" or "Bonus issue". Any other change reads "Received" or "Sent". For a fixed-yield asset, "Next payments" lists up to four upcoming payment dates with the amount your current balance earns.

### Start an operation from the header [#start-an-operation-from-the-header]

The header offers one primary action, "Claim", "Redeem", "Convert" or "Transfer". When the primary action is not "Transfer", "Transfer" sits beside it. **Convert** shows only when the asset has a conversion feature and you hold an available balance.

The **Actions** menu holds:

- "Trade", which opens the trading desk of an instrument where the asset is the base.
- "Research", which opens the instrument page of a listed instrument.
- "Copy contract address" and, when the network has a block explorer, "View on explorer".
- "Redeem" or "Convert" when they are not the primary action.
- In the Investor portal, "Delegate voting power" when the token carries voting power. The sheet takes the address that votes with your voting power, your own wallet or another one, then asks for your PIN.
- On an asset with a maturity date that cannot be redeemed yet, a greyed-out "Redeem · at maturity on" entry with the date.

The "Actions" menu holds these entries:

- **Trade**, which opens the trading desk of an instrument where the asset is the base.
- **Research**, which opens the instrument page of a listed instrument.
- **Copy contract address**.
- **View on explorer**, when the network has a block explorer.
- **Redeem** or "Convert", when they are not the primary action.
- A greyed-out **Redeem · at maturity on** entry with the date, on an asset with a maturity date that cannot be redeemed yet.

The primary action, "Transfer", "Redeem" and "Convert" stay greyed out with "Available once your claims and this asset's features have loaded" until those reads settle. **Transfer** is also greyed out when nothing is available, with "Nothing is available to transfer", or "Nothing can be transferred until the freeze lifts." when part of the balance is frozen.

## You should see [#you-should-see]

- After a submitted operation indexes, the headline figure, "Position value", "Principal" or "Balance", and **Available** change, and the matching event appears in [Activity](https://docs.settlemint.com/docs/console/essentials/activity).

## Troubleshooting [#troubleshooting]

**An action is greyed out in the header**

Signal: the primary action, "Transfer", "Redeem" or "Convert" is greyed out. Cause: the page has not finished reading
your claims and the asset's features, nothing is available to transfer, or part of the balance is frozen. Fix: read
the reason beside the action, wait for the reads to settle, and check **Available** and "Frozen" in the key figures.
Ask the asset's custodian about a frozen amount.

**The page shows Unknown asset, You don't hold this asset or Asset unavailable**

Signal: the holding page shows one of these states in place of the position. Cause: **Unknown asset** means the
address is not an asset in this organisation. "You don't hold this asset" means none of the accounts the page reads
holds it. "Asset unavailable" means the read failed. Fix: confirm the participant in "Working as" and the network, and
reopen the holding from [Portfolio](https://docs.settlemint.com/docs/console/my-assets/portfolio).

**The claim sheet in the Investor portal refuses before you enter your PIN**

Signal: in the Investor portal, the claim yield sheet shows a refusal with its reason and fix, and the claim button
stays off. Cause: the Investor portal's claim sheet checks the claim with the platform when it opens. The Console does
not run this check. The check does not submit or sign anything, and when it cannot answer, the claim returns its own
refusal. Fix: follow the fix in the sheet.

