> For the complete documentation index, see [llms.txt](https://sol-perps-bot.gitbook.io/sol-perps-bot-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sol-perps-bot.gitbook.io/sol-perps-bot-docs/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.015%** / 1.5 bps) and **Taker Fee** (default **0.045%** / 4.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.