> For the complete documentation index, see [llms.txt](https://docs.fluvion.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fluvion.io/trading-basics/portfolio.md).

# Portfolio & Analytics Dashboard

The **Fluvion Portfolio Dashboard** (`https://fluvion.io/portfolio`) provides a comprehensive command center for tracking account equity, analyzing trading performance, managing active positions, inspecting orders, monitoring VIP fee tiers, and generating programmatic API keys.

***

## Portfolio Terminal Layout

The Portfolio terminal is structured into 7 dedicated navigation modules accessible via the left sidebar:

```
+-------------------------------------------------------------------------------------------------------+
|  FLUVION PORTFOLIO (fluvion.io/portfolio)                                                             |
+-------------------+---------------------------------------------------+-------------------------------+
|  PORTFOLIO MENU   |  OVERVIEW                                         |  ASSETS VALUE                 |
|                   |  Total value: $14,250.80 USDC     [Deposit]       |  (Interactive Area Chart      |
|  [x] Overview     |                                   [Withdraw]      |   7D, 30D, 90D, All)          |
|  [ ] Positions    +---------------------------------------------------+-------------------------------+
|  [ ] Orders       |  PERFORMANCE (7D / 30D / All)                                                     |
|  [ ] Assets       |  7D ROI: +18.4%       |  7D PnL: +$2,215.40 USDC  |  7D Volume: $1,420,000 USDC   |
|  [ ] Fee tier     +-----------------------------------+-----------------------------------------------+
|  [ ] API Keys     |  DAILY PnL                        |  CUMULATIVE PnL                               |
|  [ ] Settings     |  (Bar chart of daily profit/loss) |  (Upward sloping equity curve)                |
|                   +-----------------------------------+-----------------------------------------------+
|                   |  DAILY VOLUME                     |  CUMULATIVE VOLUME                            |
|                   |  (Daily notional turnover)        |  (Aggregate notional volume growth)           |
+-------------------+-----------------------------------+-----------------------------------------------+
```

***

## 1. Overview & Performance Analytics

The **Overview** tab is your macro performance summary:

### Equity & Balance Header

* **Total Value**: Aggregate account net worth in USDC (`USDC Balance + Unrealized PnL`). Features a privacy eye toggle to obscure balances when streaming or screen sharing.
* **Quick Action Buttons**: Direct modal access to **Deposit** and **Withdraw** USDC.
* **Assets Chart**: Visualizes portfolio equity growth over customizable timeframes (**7D**, **30D**, **90D**, **All**).

### Performance Metrics (KPIs)

* **Period ROI %**: Return on investment over the selected timeframe.
* **Period PnL ($ USDC)**: Net realized and floating dollar profit/loss.
* **Period Volume ($ USDC)**: Total notional trading volume executed.

### Interactive Performance Charts

1. **Daily PnL**: Color-coded bar chart displaying net profit (green) and loss (red) for each day.
2. **Cumulative PnL**: Running total equity curve showing long-term profitability trajectory.
3. **Daily Volume**: Daily turnover bar chart helping you track active trading intensity.
4. **Cumulative Volume**: Aggregate volume progression toward higher VIP fee tier thresholds.

***

## 2. Positions

The **Positions** module provides unified tracking and execution controls for all open positions across all 80+ supported markets:

| Column                     | Description                                                                            |
| -------------------------- | -------------------------------------------------------------------------------------- |
| **Market & Side**          | Contract symbol (e.g. `SOL-PERP`) and direction (`LONG` in green, `SHORT` in red).     |
| **Margin Mode & Leverage** | `Cross` or `Isolated` badge with leverage multiplier (e.g. `10x`, `50x`).              |
| **Position Size**          | Quantity held in base asset units (e.g., 100 SOL) and notional USD value.              |
| **Entry Price**            | Volume-weighted average entry price of the position.                                   |
| **Mark Price**             | Current fair oracle mark price used for margin and liquidation valuation.              |
| **Est. Liquidation Price** | The price level where the position will be liquidated if the market moves against you. |
| **Margin Allocated**       | USDC collateral committed to backing this position.                                    |
| **Unrealized PnL & ROI**   | Real-time dollar profit/loss and return on equity percentage.                          |
| **ADL Indicator**          | 5-bar meter indicating auto-deleveraging priority queue status.                        |
| **Actions**                | **Market Close**, **Limit Close**, and **Edit TP/SL** modal triggers.                  |

***

## 3. Orders

The **Orders** module houses full order lifecycle management across three sub-views:

### A. Open Orders

* Displays resting limit orders, Stop-Market, and Stop-Limit orders waiting for trigger or execution.
* Allows editing limit prices or cancelling individual orders.
* Includes a **Cancel All** button to clear all open orders simultaneously during market turbulence.

### B. Order History

* Historical log of all orders (Filled, Cancelled, Rejected, or Expired).
* Shows order type, submit time, average fill price, filled vs. original quantity.

### C. Trade History (Execution Tape)

* Granular breakdown of every single fill event.
* Displays execution timestamp, counterparty role (**Maker** or **Taker**), and the exact fee deducted in USDC.

***

## 4. Assets & Collateral Breakdown

The **Assets** module provides a detailed audit of your capital distribution:

* **Total Collateral**: `Deposited Balance + Unsettled PnL + Floating uPnL`.
* **Free Collateral**: Collateral available to allocate toward new trades or resting limit orders.
* **Initial Margin in Use**: Margin currently locked by active positions and open orders.
* **Maintenance Margin**: The absolute minimum margin required to avoid liquidation.
* **Withdrawable Balance**: The exact settled USDC amount that can be withdrawn to your connected wallet immediately without violating open position margin requirements.

***

## 5. Fee Tier Progress

The **Fee Tier** tab displays your current trading fee schedule:

* **Effective Fee Rates**: Your active **Maker Fee** (default **0.05%** / 5 bps) and **Taker Fee** (default **0.05%** / 5 bps) across Crypto and RWA markets.
* **Custom Rates**: Displays any custom fee tier or bespoke fee discount assigned to your connected wallet.
* **Historical Fees Paid**: Audit log of fees deducted in USDC across your historical executions.

***

## 6. API Keys (Algorithmic & Bot Trading)

For institutional traders, quantitative funds, and automated trading bots, the **API Keys** module enables programmatic access to the Fluvion high-performance CLOB:

### Creating an API Key

1. Click **Create API Key**.
2. Set a recognizable key label (e.g. `grid-bot-v1`).
3. Select Permissions:
   * **Read-Only**: Query account balances, position states, and historical trade data.
   * **Trade**: Submit, amend, and cancel orders via the low-latency REST and WebSocket APIs.
4. **IP Whitelisting** *(Highly Recommended)*: Restrict order execution to your designated server IP addresses.
5. Sign the authorization prompt in your connected wallet to generate and register the cryptographic trading key pair.

> \[!CAUTION] **API keys can never withdraw funds.** Fund withdrawals strictly require an explicit on-chain transaction signature from your primary connected wallet.

***

## 7. Settings

Customize your trading experience and account security:

* **Default Leverage & Margin Mode**: Set your default starting leverage (e.g. `10x`) and preferred margin mode (`Cross` or `Isolated`) for new order tickets.
* **Slippage Tolerance Presets**: Configure default market order slippage (`0.1%`, `0.5%`, `1.0%`, or custom).
* **Order Confirmations**: Toggle the confirmation pop-up modal on or off for rapid one-click order execution.
* **Session Key Management**: Inspect active session validity, renew expired keys, or instantly revoke the session key to disable web order submissions.
* **Display & Notifications**: Toggle chart sounds, order fill alerts, and liquidation warning notifications.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.fluvion.io/trading-basics/portfolio.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
