Portfolio shows the holdings of the person or organisation selected in “Working as”, and every figure covers that participant's wallets only. While you work as someone else, the page shows none of your own holdings until you select “Return to yourself”. Use “Portfolio” to inspect what a participant already owns, check what it has earned, collect pending returns, and start a “Transfer”, “Redeem”, “Claim yield” or “Claim dividend” operation from a holding. To acquire a new position through an open offering, use Invest instead.
The page has the tabs Holdings, “Insights”, “Returns” and “Statements”. “Holdings” shows what the participant owns now: balance, value, available amount, frozen amount, cost basis, and unrealised profit or loss, the gain or loss on what it still holds. “Insights” shows where the value sits.
Returns shows what the holdings have paid, as a lifetime total and the amount still to claim, by income type and by asset, and lists realised profit or loss, the gain or loss on what the participant sold or transferred away. A position with a balance on “Holdings” shows nothing on “Returns” until it pays something.
Statements holds the participant's statements. When the organisation has custody operations or a bank rail turned on, a “Transfers” tab lists the participant's deposits, withdrawals, bank payments and cash-outs. The Investor portal shows the same tabs and holding pages, with the same figures and rules.
The Portfolio page on the Holdings tab, with the three value figures and the “Needs you” card.
On the Holdings tab, the Needs you card comes first when an action waits on you, and each row carries the button for its action.
Steps
Review portfolio value
Open “Wealth”, then Portfolio. On a tab other than “Holdings”, the breadcrumb ends with the tab, such as “Wealth”, “Portfolio” and “Returns”, and the page title names the tab.
Three figures sit over the tabs and stay the same on every tab:
- Portfolio value with its change over 24 hours.
- Unrealized P&L with its percentage on cost. A gain too small for two digits reads
<0.01%, a loss>-0.01%. - Income earned, with a line under it. That line gives the amount you collected this year. When that is zero, it gives the amount pending collection, for example “$110.77 pending collection”, and when both are zero, it reads “None collected this year”.
Each figure opens the tab that explains it. When some holdings have an incomplete cost basis, Unrealized P&L adds up only the holdings that have one. The figure starts with ≈, shows no percentage on cost, and the line under it says which holdings it leaves out, for example “Excludes 1 holding with an incomplete cost basis: MANOR”. The line wraps onto up to three lines inside the figure's tile. When the list is longer still, it ends in an ellipsis. Hover or focus the line to see every excluded holding with its name. When no holding has a cost basis yet, the line reads “No cost basis yet”. When the cost basis is incomplete and no partial total can be given, it reads “Unknown: some holdings have an incomplete cost basis”. How cost basis and profit or loss are computed explains the figures.
The value chart sits on the Holdings tab over the holdings table, and again on the “Insights” tab. It plots the participant's held balances at price over a selectable range. An asset with no price counts as zero on the chart. It opens on the last month, one of eight ranges from the trailing 24 hours up to all time. On “Holdings” you pick the range in the chart's header and the comparison sits under the plot. On “Insights” both controls sit under the tabs. A portfolio with no value to chart shows no chart on “Holdings”.
Compare with prior period draws the period of the same length just before the range as a dashed line. All time has no earlier period, so for that range the switch is off and cannot be turned on, with the reason beside it. The chart leaves out pending income, because the participant does not hold it yet. Collected income becomes a balance, so a payout can move the chart as well as the “Returns” figures.
Inspect holdings
When an action waits on you, such as an approval, an invitation, a vote or a yield or dividend to claim, a Needs you card sits over the table. It counts those actions and lists up to six with their deadline. “View all” opens Actions for the rest. Actions that wait on someone else sit in a closed “Waiting on others” disclosure under the rows. The card does not appear when nothing waits on you.
Use Search holdings… to find a holding. The table shows “Symbol”, “Balance”, “Value”, “Unrealized P&L” and the row actions. A holding whose value equals its cost shows an unrealized P&L of $0.00, the same zero the figure over the tabs adds up.
Add “Token name”, “Contract address”, “Cost basis”, “Average cost”, “24h”, “Available” and “Frozen” through the View control in the toolbar. A value that rounds the exact balance times the price to the cent starts with ≈.
Hover Unrealized P&L for the “Total return”, the “24h change” and a chart of the “Last 30 days”. When a holding's cost basis is unknown, both “Cost basis” and “Unrealized P&L” show a warning mark, and hovering it reads “Unknown: some acquisitions of this asset had no price, so its cost basis and unrealized P&L cannot be calculated.”
Expand a row to see its token name, cost basis, average cost, available and frozen amounts, and contract address. Select a row to open the holding page, described under Holding. “Export” saves every holding that matches the search and filters as CSV or JSON.
Deposit into your gateway
When your organisation has custody operations or a bank rail turned on and you have a custody gateway, Deposit sits in the page header beside “Claim all”. It opens the same deposit dialog as the Investor portal.
- “From a wallet” shows your gateway address as a code and a QR code, with the coins it accepts. Send only those coins to that address. While the gateway is paused, the dialog says not to send a deposit until it resumes.
- “By bank transfer”, when your bank link is set up, shows the account to pay and the payment reference or virtual IBAN that makes the payment yours, and says when that bank connection is paused.
- When you have no gateway and no bank link, “Deposit” does not appear.
Withdraw from your gateway
Withdraw sits beside “Deposit” when your organisation has custody operations or a bank rail turned on. It opens the same withdraw dialog as the Investor portal, described in Wallet deposits and withdrawals.
- To a wallet shows the “Auto-collect” switch and “New withdrawal”. The request sheet lists your custody receipts and the payout addresses approved for your gateway, prices the fee for the amount you enter, and asks for your transaction PIN or code. A refused request shows the reason and keeps the sheet open.
- To my bank account, when your bank link is set up, requests a cash-out as Bank transfers describes. In the Console the booked step lists the redemption lines you already requested, and offers no way to request a new one. With no active payout account for the token, the method shows “Bank accounts”, which opens Bank accounts so you can propose your own account. While your participant account is suspended, closed, terminated or restricted from withdrawals, the request is refused and the dialog says an administrator can lift a suspension, closure or restriction, but a termination is final.
- When you have no gateway, the dialog says “No gateway yet”. While the gateway is paused, “New withdrawal” is off.
- Under “New withdrawal” the dialog lists your withdrawals, open ones first. “View all” opens the “Transfers” tab.
Prove the wallets your withdrawals go to on Withdrawal destinations.
Start a holder operation
The first enabled operation of a row shows as a button in the row, and the others sit in the row menu. On a phone every operation sits in the menu. The operations have different requirements and results:
Each operation opens its own sheet. On the Transfer sheet, the confirm step also shows a “Pre-trade compliance check” for each recipient and amount, which says whether the transfer would clear before you sign.
When that check says the transfer would revert, rather than wait for approval, “Confirm transfer” stays disabled and the reason beside it names the failed checks. Confirming with your PIN or authenticator code submits the operation.
Settle ended offerings
When a Primary Offering you bought into has ended and still owes you something, it is listed in the “Offerings to settle” card on the Holdings tab. A successful sale with tokens you can take now shows “Claim tokens”. A failed sale with money to return shows “Claim refund”. “Claim all” settles offerings you bought into, and “Collect all” on “Returns” claims income from assets you already hold.
Select a row's button to settle that one offering without leaving Portfolio. A sheet lists what you receive: the tokens, or the refund in each currency you paid. Confirm with your PIN or authenticator code.
Claim all settles every listed offering at once. The button carries the number of offerings, for example “Claim all (3)”. It is hidden while the list loads, when the list cannot be read and when nothing is owed. The sheet lists each offering with its claim or refunds, and one verification covers all of them.
Each claim and each refund is its own transaction, so the sheet shows one result per claim or refund. “Claimed” or “Refunded” means it settled. “Processing” means the transaction was accepted and shows in your activity once it is mined. “Failed” gives the reason, and the others still go through. “Try again” resends only the offerings that failed. An offering that owes this account nothing says “Nothing to claim from this account”, and “Open offering” takes you to its page, where you can settle from the account that is owed.
One Claim all settles at most 20 offerings. When more are listed, the sheet says how many are left, and a second “Claim all” settles them. When the organisation's primary market is read-only, “Claim all” and the row buttons are disabled with that reason. The claims sign from the participant's custody account. When the raise falls short explains refunds. The Investor portal uses the same sheet.
Read allocation on Insights
Insights shows where value sits: “Value by asset class”, “Largest holdings” and “By country”. Each answer is a card of bars with the value and its share of the portfolio. Value on assets that have no country shows as “No country”. The “Holdings by country” map sits below the value trend. Over the cards, an attention row flags “Servicing events in the next 14 days”, “Holdings partly frozen” and a missing identity registration, and is absent when none applies.
Read returns
Returns shows what the holdings have paid.
Income mix charts the lifetime total by return type, fixed income, dividend, and interest, not by individual asset. A return type drops off it once it has nothing pending and nothing collected, so an accrued payout that is not claimed yet still shows. A type that earned something never reads 0%: a share too small to round reads <0.1%, and the largest share reads >99.9% while another type earned something, so the shares never add up to more than 100%.
Upcoming events lists up to ten dividend payments and the next coupon of each fixed income holding, due in the next 30 days, through the end of the thirtieth day (UTC). A coupon is due when its period ends, and its amount is what your current balance earns over that period. Interest accrues continuously and has no payment date, so it never appears here: with nothing due, the list says interest is shown under “Returns by asset”. A dividend or coupon leaves the list once its payment time is reached, and from then on it counts as “Pending” and “Collect all” offers it. Every figure on the tab, and “Collect all”, judge that moment by the same clock: the time of the latest block the platform has indexed.
Returns by asset breaks earned and pending totals down per holding, plus what each has already collected. Use the “Type” filter to show only fixed income, dividend, or interest holdings. “Next event” shows the next dividend payment date for a dividend holding and the end of the next coupon period for a fixed income holding. An interest holding reads “Accrues daily, claim anytime”, or “Accrual starts” with the date while its accrual has not begun. A dash means nothing is scheduled, or, for an interest holding, that its accrual is paused, you are excluded from it, or it no longer runs for you. The footer under the table totals the rows you can see:
The footer starts with the number of distinct assets it covers, and it changes with the filter. Filter by “Type” to see what one return type is worth, or which holding moves the total. Each footer total adds the row figures as they are shown, each rounded to the cent, so the rows always add up to it. A total starts with ≈ when a row it adds was rounded.
Income earned over the tabs is the lifetime total, collected plus pending, added up from the “Returns by asset” rows the same way. The line under it gives the amount collected since the start of the year.
Annual rate gives every holding's rate per year. A fixed income asset pays its rate each period, so the column scales that rate to a 365-day year, the figure its holding page shows beside the period rate.
Realized disposals lists the latest 100 sales and transfers away, with “Date”, “Asset”, “Quantity”, “Proceeds”, “Cost of disposal” and “Realized P&L”, and states the “Realized total” beside its title. When every disposal is listed and each has a known “Realized P&L”, the total adds the row figures as they are shown. Otherwise it covers all disposals, including those beyond the latest 100. A row whose figure cannot be computed explains why when you hover it.
Export P&L downloads “Realized disposals”, the “Realized series” or the “Unrealized series” as a CSV file, including disposals beyond the latest 100.
For a holding that earns interest, Rate history charts the annual rate after each change.
Collect all returns
Collect all claims the returns the participant can collect now, across fixed treasury yield, dividends and interest, up to ten per wallet verification. Use it when several holdings owe income at the same time, in place of claiming each one from its holding. The button sits in the header of the “Returns” tab, beside “Export P&L”, and carries the number of returns waiting, for example “Collect all (3)”.
The button keeps its place from the moment the tab opens. It is unavailable while the list of collectable returns loads, and when nothing is collectable it reads “Collect all”, stays unavailable, and gives the reason “Nothing left to collect.”
- If the participant has two or more custody accounts that can sign, its wallets on this network, choose the account in the Collect from selector beside the button. Without a choice, the primary account collects, or the first account that can sign when none of them is primary. The choice holds until you reload the page.
- Select Collect all (3). The “Collect all returns” sheet opens with one row per return: the asset, the return type, which is “Fixed income”, “Dividend”, or “Interest”, the amount in the asset that pays it, marked “Estimated”, and the status “Ready”.
- Select Collect all, then enter your PIN or an authenticator code from your authenticator app or identity provider. That one verification covers every row in the round.
- Follow the rows as they change status. A line under the rows counts the result, for example “2 of 3 collected”.
- If the sheet says “7 more returns will be collected in the next round.”, select Collect next 7 and verify again. If a row failed, the button reads “Try again”. Close the sheet when you are done. The “Returns” figures and the “Collect all” count reload.
The “Collect all returns” sheet with the account the transaction executes from and one row per return.
The sheet opens with the account the transaction executes from and its signing key, then one row per return: the asset name and return type, the amount marked “Estimated” with the symbol of the asset that pays it, and the status “Ready”. “Cancel” and Collect all sit at the foot of the sheet.
How Collect all claims your returns explains what is collected, what the platform checks, and what each row status means.
Download a statement
The Statements tab lists the statements of the participant's wallets. A statement shows the opening and closing balances and the movements of one wallet over a period, and your organisation's statement policy sets how often they are produced. Each one appears once its period has closed. The table shows “Period”, “Wallet”, “Status” and “Download”. “Reconciled” means the opening balances plus the listed movements equal the closing balances for every security. “Incomplete” means they do not, and the statement says not to rely on it.
Select a download in a row, in “CSV”, “Excel workbook” or “PDF”. The button reads “Preparing…” while the file is made. When it fails, the Console shows “The statement could not be downloaded. Try again.” With no statement yet, the tab reads “No statements yet”. The Statement pages control pages through a long list.
Follow your transfers
The Transfers tab shows when your organisation has custody operations or a bank rail turned on. It lists the gateway deposits and withdrawals, bank payments and cash-outs of the participant you work as, the same rows the Investor portal shows on its “Transfers” tab, as Wallet deposits and withdrawals and Bank transfers describe.
- Transfers still on their way sit under “In progress”, the rest under “History”, newest first, each with its stage in plain words.
- Search by amount, stage or reference, and narrow the list with the type filter.
- “Cancel” sits on a withdrawal you can still cancel. It asks for your transaction PIN or code and gives your receipts back.
- With nothing yet, the tab reads “No transfers yet”. An organisation without custody operations or a bank rail shows no tab, and the address reads “Transfers are not available”.
When you keep the organisation's books, its movements stay off this tab and show on Custody books.
Which account a claim pays
A participant can hold the same asset through several custody accounts, and a yield, dividend or interest payment is owed to the account that held the balance. Each claim sheet asks every custody account the participant has on the network what it can claim now.
- When one account is owed, the sheet locks to that account and shows it as “The wallet that is paid”.
- When several are owed, a picker lists each account with its amount.
- When none is owed, the sheet says “Nothing is owed to any of your accounts” and you cannot submit the claim.
- An account the platform cannot read blocks only itself, and a notice names the wallets that could not be checked.
The account on the sheet signs the claim, so the verification step does not ask which account signs, and the amount shown is the amount that wallet receives. A participant with one account sees no extra step.
How cost basis and profit or loss are computed
The cost basis is what a position cost, kept as a weighted average for each wallet and asset in the organisation's base currency.
- Acquisitions. A mint, or a transfer received from a wallet of another participant or from a wallet no participant holds, adds the quantity and its cost, and the average cost becomes the total cost divided by the quantity held.
- Disposals. A burn, or a transfer to a wallet of another participant or to a wallet no participant holds, is booked at the average cost at that moment. A disposal larger than the position is limited to the quantity held.
- Moves between your own wallets. A transfer between two wallets of the same participant moves the quantity and its average cost, with no profit or loss. When the sending wallet's cost is unknown, the receiving wallet's cost becomes unknown too.
- Prices. A trade settled on a trading venue uses the trade's quote amount: the buyer's cost includes the buyer's fee, and the seller's proceeds exclude the seller's fee. Every other movement uses the latest price recorded for the asset before the movement, or the asset's current price when no price is recorded.
- Unknown cost. An acquisition with no price makes the position's cost unknown, and a later priced acquisition does not make it known again. The Console then shows the cost basis and the unrealised profit or loss as unknown. A holding acquired before the asset had any price, such as a mint that lands before the issuer's first price, takes that first price once it is published.
Unrealised profit or loss is the current value minus the cost basis, with each rounded to the cent once. The percentage divides the exact difference by the exact cost basis and is rounded to two decimals.
Realised profit or loss is the proceeds of a disposal minus the disposed quantity at the average cost, rounded down. A disposal with no usable price records zero proceeds and is marked “No price was available when this sale happened, so its proceeds and profit are not calculated.” A disposal whose cost is unknown has no realised figure and is marked “The cost of some units sold is not recorded, so the profit is not calculated.”
How Collect all claims your returns
Collect all verifies the wallet once and then claims each listed return as its own transaction. The platform sends the claims one at a time. A claim it cannot confirm in time is marked “Unconfirmed”, and the platform sends the next one. A claim that fails is recorded on its row and does not stop the claims after it, and it does not undo the claims before it. Every claim pays the wallet of the participant named in “Working as”.
A round claims in a fixed order: fixed treasury yield first, then dividends by payment date, then interest. Each dividend is its own return, so a token with two open dividends gives two rows. One fixed treasury yield claim can pay several completed periods at once. Returns past the first ten stay Ready and wait for the next round, which needs a new verification.
What counts as collectable
The list covers the participant's holdings in the current organisation, on the network picked in the account menu. The platform measures dates against the time of the latest indexed block. It reads the three return types in one snapshot, so every row reflects the same block.
A return that meets none of these rules is left out of the list.
Who can collect
Starting a collection needs no token role, but a claim whose feature requires a role the wallet lacks fails with “Your wallet is not allowed to collect this return.” The claims sign from the custody account of the participant named in “Working as” on the selected network. That account must sign on the platform side.
A wallet that signs in the browser cannot be collected in a batch: its rows fail with “This wallet signs in the browser, so this route cannot ask it to sign. Use the browser-wallet route.”, and you claim those returns one at a time from the holding. In the Console, when none of the participant's custody accounts on the network can sign, the Returns tab shows “None of your custody accounts can sign a claim right now. Check their status in Settings.” and “Collect all” stays unavailable.
What the platform checks
- Verification. A wrong PIN or authenticator code stops the request before any claim is sent.
- Collectable returns. When you confirm, the platform reads the collectable returns again and claims those, not the list the sheet opened with. A row it no longer finds collectable goes back to “Ready”.
- Fixed treasury yield. Right before it submits a fixed treasury yield claim, the platform reads the yield feature on the network to confirm that a completed, unclaimed period remains.
- Feature rules. Each claim runs under the rules of its feature and the token's compliance rules, as a claim from the holding would.
Amounts: estimated and paid
Until a claim lands, its row shows the amount quoted when the sheet opened, marked Estimated. Interest keeps accruing, and another fixed treasury yield period can complete, before the claim lands, so a claim can pay more than its quote. Once the claim lands, the row shows the amount the claim paid, as recorded by the indexer, the platform service that reads events from the network. If that record cannot be read yet, the row keeps the quote and the “Estimated” mark.
Both amounts show at most six decimal places. A paid amount with more decimals than that is rounded and marked ≈: hover over it, focus it or tap it to see the exact amount the wallet received.
Row statuses
A failed or skipped row shows one of these reasons:
A claim that the queue accepted and that then fails on the network shows the decoded contract error, or “The collection did not complete.”, followed by its Reference ID. If the whole request fails before any result comes back, every row that was collecting fails with “The collection could not start:” and the error.
Try again and “Collect next” both start a new round. The platform reads the list again, so a round claims only what is still listed as collectable.
Troubleshooting
A cost basis or unrealised profit or loss figure shows a warning mark
Signal: a holding's “Cost basis” and “Unrealized P&L” show a warning mark instead of an amount, and hovering it reads
“Unknown: some acquisitions of this asset had no price, so its cost basis and unrealized P&L cannot be calculated.”
Cause: at least one acquisition of that position had no price when it was booked, so the platform cannot know what the
position cost. Fix: ask your organisation's administrator to have a holder of the “Feeds manager” role publish a price
for the asset. An acquisition that came before the asset's first price takes that price once it is published. The
Unrealized P&L figure over the tabs sums the other holdings, starts with ≈ and names the holdings it leaves out.
Transfer is greyed out on a holding the participant owns
Signal: Transfer is greyed out and reads “The selected account has no available balance to transfer.” Cause: the account the transfer would send from has nothing available, because its balance is frozen, on hold or pending in another transfer. Fix: add “Available” and “Frozen” through “View” to see how the balance splits, then ask the asset's custodian why the balance is frozen or held, or wait for the pending transfer to clear.
Redeem, Claim yield or Claim dividend does not appear on a row
Signal: you expect “Redeem”, “Claim yield” or “Claim dividend” on a holding, and it is missing. Cause: each one has its own condition, and Start a holder operation lists them. Fix: for Redeem, wait for the asset's maturity date. This page has no path to redeem early. For a claim, confirm in Actions that a claim is pending for the participant.
No holdings appear
Signal: the page reads “No holdings yet” or “Register your identity to hold and trade assets”. Cause: the active participant holds no tokens in this organisation on the active network, or has no registered identity. Fix: confirm the participant named in “Working as” and the network in the account menu. Select Open identity steps to register the identity, or “Browse offerings” to invest.
Collect all is unavailable on the Returns tab
Signal: the Collect all button on the “Returns” tab is unavailable and gives the reason “Nothing left to collect.” Cause: the platform found nothing the participant's wallet can collect now on the selected network. A dividend before its payment date or after its claim deadline, a fixed treasury yield period that has not completed, and interest on a paused feature are all left out. When none of the participant's custody accounts on the network can sign, the Console shows “None of your custody accounts can sign a claim right now. Check their status in Settings.” beside the unavailable button. Fix: confirm the participant in “Working as” and the network in the account menu. For the signing message, ask your organisation's administrator to check the custody accounts.
The Returns tab says the collection could not start
Signal: the tab shows “The collection could not start:” followed by an error, and a “Try again” button, and Collect all stays unavailable. Cause: the platform could not read the list of collectable returns. Fix: select “Try again”. Nothing was claimed, because the list is read before any verification.
A row shows Unconfirmed
Signal: a row in the “Collect all returns” sheet shows Unconfirmed with the message “The collection was sent, and its result is not confirmed yet. Check the reference before you collect it again.” and a “Reference ID”. Cause: the claim was sent, but the Console could not confirm whether it settled. The claim can still land. Fix: keep the reference and wait. Then reopen the “Returns” tab and check the “Collected” figure for that asset in “Returns by asset” before you collect it again.
A row fails with a message about a browser wallet
Signal: a row fails with “This wallet signs in the browser, so this route cannot ask it to sign. Use the browser-wallet route.” Cause: the participant's wallet signs each transaction in the browser, and Collect all only claims through accounts that sign on the platform side. Fix: claim that return on its own from the holding.
API routes
The same flow is available through the Platform API, for the wallet the request acts for:
GET /api/lists every return the wallet can collect now, in claim order. It writes nothing. An empty list means there is nothing to collect. Send thev2/ portfolio/ returns/ collectable X-Custody-Account-Idheader to read what one account can claim. Which custody account does a Platform API request use? explains the header.POST /api/takes thev2/ portfolio/ returns/ collections walletVerificationin its body and claims up to ten returns. It answers200with one result per item:collected,queued,failedorskipped. Failed and skipped items carry areasonand amessage.remainingcounts the collectable returns the request did not attempt. Send the sameIdempotency-Keyheader again to replay the settled claims instead of paying twice. Send a new request to collect what remains.GET /api/lists what the wallet claimed in one transaction, with the amount each claim paid. Read it after a claim settles. An empty list means no claim by this wallet is indexed for that transaction yet.v2/ portfolio/ returns/ collections/ {transaction Hash}