# Portfolio

Your portfolio is your complete trading dashboard. Track all your positions, performance, wallet balance, and trade history in one place.

***

## Viewing Your Portfolio

Send `/portfolio` to see your complete portfolio overview.

### What You See

| Section            | Description                                            |
| ------------------ | ------------------------------------------------------ |
| **Total Balance**  | Combined value of all SOL + all token positions in USD |
| **SOL Balance**    | Available SOL in your wallet                           |
| **Open Positions** | All tokens you're currently holding                    |
| **Today's P\&L**   | Profit/loss from today's trades                        |
| **Total P\&L**     | Overall profit/loss since you started                  |

***

## Open Positions

Each open position shows:

| Metric            | Description                                         |
| ----------------- | --------------------------------------------------- |
| **Token**         | Symbol and name                                     |
| **Size**          | Number of tokens you hold                           |
| **Entry Price**   | Average price paid per token (in USD)               |
| **Current Price** | Latest market price (updated on refresh)            |
| **Value**         | Current value of your position in SOL and USD       |
| **P\&L**          | Absolute gain/loss and percentage gain/loss         |
| **TP/SL Status**  | Whether your take profit or stop loss has triggered |

### Position States

| State                | Meaning                                     |
| -------------------- | ------------------------------------------- |
| **Open**             | Active position, not closed                 |
| **Partially Closed** | Some tokens sold, some remain               |
| **TP Hit**           | Take profit target was reached and executed |
| **SL Hit**           | Stop loss triggered and position was sold   |

***

## Refresh Balance

Use the **"Refresh"** button to update all token prices. ARCHONE batch-fetches current prices from market feeds so you see the latest values.

Prices are fetched in parallel for efficiency — large portfolios load quickly.

***

## Position Actions

For each open position, you can:

### Sell

Tap **Sell** to sell your tokens:

* **100%** — Sell all tokens at market price
* **Custom** — Sell a specific amount or percentage

### Set TP/SL

Tap **TP/SL** to configure exit targets:

* **Take Profit 1/2/3** — Sell portions at price targets
* **Stop Loss** — Sell all if price drops below threshold
* **Trailing Stop** — Lock in profits dynamically

### View Trade History

Tap **History** to see all trades for this token:

* Every buy and sell with timestamps
* Prices and amounts
* Transaction hashes

***

## Trade History

The **Recent Trades** section shows your last 20 trades:

| Field      | Description             |
| ---------- | ----------------------- |
| **Type**   | BUY or SELL             |
| **Token**  | Symbol traded           |
| **Amount** | SOL spent/received      |
| **Price**  | Execution price         |
| **P\&L**   | Profit/loss (for sells) |
| **Time**   | When the trade executed |
| **Status** | CONFIRMED or FAILED     |

Tap any trade to see full details and the transaction hash.

***

## P\&L Calculation

### Unrealized P\&L

The P\&L on open positions is **unrealized** — it's the theoretical gain or loss if you sold right now at current prices. It's calculated as:

```
Unrealized P&L = (Current Price - Entry Price) × Token Amount
Unrealized P&L % = (Current Price - Entry Price) / Entry Price × 100
```

### Realized P\&L

Once you sell, the P\&L becomes **realized** — it's locked in. Your confirmed trades show realized P\&L.

### Portfolio P\&L

Your total portfolio P\&L combines:

* Realized P\&L from closed trades
* Unrealized P\&L from open positions
* Fees paid (subtracted)

***

## Privacy Mode

Enable privacy mode from `/settings` to hide your portfolio balance when showing the bot to others.

When privacy mode is on:

* Portfolio shows "••••••" instead of balances
* Trade history remains visible
* You can still see everything — others can't

This is useful when:

* Showing the bot to friends
* Screenshoting for social media
* Viewing in public

***

## Daily Summary

ARCHONE sends a daily trading summary when enabled in `/settings`. This includes:

* Total P\&L for the day
* Number of trades executed
* Biggest winner and loser
* Positions opened/closed

***

## Limitations

* Portfolio values are estimates based on market data — actual values may vary slightly
* P\&L calculations use the latest available price — during high volatility, prices change rapidly
* Some tokens may show "N/A" for price if market data is unavailable
* Very large portfolios with hundreds of tokens may take longer to load


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.archone.trade/core-features/portfolio.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.