> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tradeonsight.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Portfolio Management

> Track positions, monitor P&L, and manage open orders

## Portfolio Overview

Your portfolio consists of three main components: open positions, pending limit orders, and closed positions. Onsight provides real-time tracking and performance metrics for all your trading activity.

<CardGroup cols="3">
  <Card title="Positions" icon="chart-pie">
    Open positions with unrealized P\&L and current market value
  </Card>

  <Card title="Orders" icon="list">
    Pending limit orders waiting to be filled or cancelled
  </Card>

  <Card title="History" icon="clock-rotate-left">
    Complete record of all filled orders and closed positions
  </Card>
</CardGroup>

## Viewing Positions

Access your open positions under **Portfolio** on the home screen.

### Position Details

Each position displays comprehensive information:

```txt Position Details Example theme={null}
Will Artificial Intelligence be TIME's Person of the Year for 2026?
Outcome: Yes

💰 Total Value | Qty of Shares
📊 Entry Price → Current Price
📈 Unrealized P&L
🗓️ Market End Date
📆 Time Held

💡 P&L remains unrealized until you close a position.
```

### Understanding Position Metrics

<AccordionGroup>
  <Accordion title="Current Value">
    **Total sum  value** of currently held shares in a position.

    Calculated as: `(Shares * Current Price)`

    Current value does not include fees.
  </Accordion>

  <Accordion title="Shares">
    **Total shares you own** in this outcome.

    * Accumulated from one or more buy orders
    * Can be partially sold (25%, 50%, 75%, 100%)
    * Shown in number of shares (not dollar value)

    Example: 145.50 shares means you own 145.50 shares of the YES outcome.
  </Accordion>

  <Accordion title="Entry Price (Average Cost)">
    **Average price paid per share** across all purchases.

    Calculated as: Total Cost ÷ Total Shares

    Example:

    * First buy: 100 shares at 0.65 = 65.00
    * Second buy: 45.5 shares at 0.75 = 34.14
    * Average: 99.13 / 145.5 = 0.681/share

    <Note>
      Entry price accounts for all buys but not any sells. If you sell and rebuy, average may change.
    </Note>
  </Accordion>

  <Accordion title="Current Price">
    **Live market price** for this outcome right now.

    * Updates in real-time from Polymarket order book
    * Shows best available bid (for selling)
    * Used to calculate current market value
    * Changes as traders buy and sell

    <Tip>
      If current price is higher than your entry price, you have unrealized profit. If lower, unrealized loss.
    </Tip>
  </Accordion>

  <Accordion title="Curent Value">
    **What your position is worth** at current market price.

    Calculated as: Position Size × Current Price

    Example: 145.50 shares x 0.725 = 105.49

    This is how much you'd receive (before fees) if you sold your entire position right now at market price.
  </Accordion>

  <Accordion title="Unrealized P&L">
    **Profit or loss on paper** if you closed the position now.

    Calculated as: Market Value - Cost Basis

    * **Positive (+)** = Profitable position (in the money)
    * **Negative (-)** = Losing position (underwater)
    * **Percentage** = (P\&L ÷ Cost Basis) × 100

    Example: 105.49 - 99.68 = +\$5.81 profit (+5.8%)

    <Info>
      "Unrealized" means the profit/loss is not locked in yet. It changes as the market price moves. Only becomes "realized" when you sell.
    </Info>
  </Accordion>
</AccordionGroup>

## Managing Positions

### Selling Positions

Close or reduce your position to realize profits or cut losses:

<Steps>
  <Step title="Select Position">
    From **Positions**, click the market you want to sell.

    You'll see:

    * Position details
    * Unrealized P\&L
    * **Close Position** button
  </Step>

  <Step title="Choose Sell Amount">
    Select what percentage to sell:

    <Tabs>
      <Tab title="Partial Sell">
        **Lock in profits while staying exposed:**

        * **25%** - Take small profit, keep most exposure
        * **50%** - Split position, secure half the gains
        * **75%** - Reduce risk, keep small remaining position

        <Tip>
          Partial sells are great when you have profits but think there's more upside. Secure some gains while staying in the game.
        </Tip>
      </Tab>

      <Tab title="Full Close">
        **100%** - Sell entire position

        **When to close fully:**

        * Take all profits and move on
        * Cut losses on bad trades
        * Market resolved or about to resolve
        * Need cash for other opportunities

        <Check>
          Closing 100% removes the position from your portfolio completely.
        </Check>
      </Tab>

      <Tab title="Custom Amount">
        **Custom** - Enter exact number of shares

        Useful for:

        * Precise position sizing
        * Selling specific dollar amounts
        * Complex strategies

        Must sell minimum 5 shares (Polymarket requirement).
      </Tab>
    </Tabs>
  </Step>

  <Step title="Choose Order Type">
    * Choose **Market** or **Limit**
    * Select price preset or input custom amount (for Limit only)
  </Step>

  <Step title="Execute Sell">
    1. Review sell details:
       * Shares being sold
       * Price
       * Estimated total proceeds including fee
       * Fee (after 1% fee)
       * Net proceeds
       * Estimated P\&L
    2. Click **Confirm** to sell
    3. Confirmation shows exact proceeds and fee

    <Note>
      Use market orders for instant execution. You receive the best available bid price at the moment of sale.
    </Note>
  </Step>
</Steps>

### Position Actions

<CardGroup cols="2">
  <Card title="View Market" icon="chart-line">
    See the full market page with current prices, volume, and buy options. Useful for adding to your position.
  </Card>

  <Card title="Sell Position" icon="dollar-sign">
    Enter the sell flow to close or reduce your position. Choose amount and execute immediately.
  </Card>
</CardGroup>

## Managing Orders

Track and manage pending limit orders from **Orders**.

### Order Status

<Tabs>
  <Tab title="Live Orders">
    **Pending limit orders** waiting in the order book:

    * Order ID (unique identifier)
    * Market name
    * Side (BUY/SELL)
    * Price and size
    * Filled amount (partial fills)
    * Time remaining (if expiring)

    <Info>
      Live orders can be cancelled anytime. Funds are locked until filled or cancelled.
    </Info>
  </Tab>

  <Tab title="Filled Orders">
    **Completed orders** that executed successfully:

    * Execution timestamp
    * Fill price (actual price paid/received)
    * Total shares received
    * Fee paid
    * Transaction hash (on-chain proof)

    <Check>
      Filled orders move from Orders to Positions (for buys) or reduce your position (for sells).
    </Check>
  </Tab>

  <Tab title="Cancelled Orders">
    **Orders removed** before execution:

    * Cancellation timestamp
    * Reason (manual, expired, insufficient funds)
    * Funds returned to available balance

    No fees charged on cancelled orders.
  </Tab>
</Tabs>

### Cancelling Orders

Cancel limit orders that haven't filled yet:

<Steps>
  <Step title="Find Order">
    Go to **Orders** and locate the live order you want to cancel.
  </Step>

  <Step title="Cancel Order">
    1. Click the order to view details
    2. Click **Cancel Order** button
    3. Confirm cancellation

    <Check>
      Cancellation is instant. Funds return to your tradable balance immediately.
    </Check>
  </Step>
</Steps>

<Warning>
  **Cannot cancel:**

  * Orders that have already filled
  * Orders currently matching
  * Orders from other platforms (only Onsight orders)

  If an order just filled, it will appear in your positions instead of orders list.
</Warning>

### Why Cancel Orders?

<AccordionGroup>
  <Accordion title="Price Moved Away">
    Market price moved and your limit order is now too far from current price to fill.

    **Example:** You set buy limit at 0.60, market is now at 0.75. Cancel and place new order at \$0.72.
  </Accordion>

  <Accordion title="Change of Mind">
    Your analysis or prediction changed based on new information.

    **Example:** News broke that changes your thesis. Cancel and reassess before entering at different price or side.
  </Accordion>

  <Accordion title="Need Liquidity">
    You need the locked funds for another trade opportunity.

    **Example:** Better opportunity emerged. Cancel old order to free up cash for new trade.
  </Accordion>

  <Accordion title="Too Long to Fill">
    Order has been open for a long time without filling.

    **Example:** Limit order open for 2 days with no partial fills. Market may never reach your price. Cancel and try market order or different price.
  </Accordion>
</AccordionGroup>

## Balance Metrics

Your home screen displays your balance metrics:

### Balances Overview

```txt Balances Overview theme={null}
BALANCES
PORTFOLIO: $89.85
💰 Tradable Balance: $10.36
💼 Open Positions: 51.67
📋 Pending Limit Orders: 27.82
```

<AccordionGroup>
  <Accordion title="Tradable Balance">
    **Available USDC.e** for new trades.

    This is your "buying power" - liquid funds not locked in positions or orders.

    <Tip>
      Keep some tradable balance for opportunities. Don't deploy 100% of funds at once.
    </Tip>
  </Accordion>

  <Accordion title="Open Positions Value">
    **Total market value** of all open positions.

    Sum of: (Position Size × Current Price) for each position

    This is what you'd receive if you sold everything right now (before fees).
  </Accordion>

  <Accordion title="Pending Limit Orders">
    **USDC.e locked** in pending limit orders.

    For BUY orders: Price × Size locked For SELL orders: Shares locked (shown as dollar value)

    These funds return to tradable balance when orders fill or get cancelled.
  </Accordion>
</AccordionGroup>

### Net Worth Calculation

Your total account value consists of:

<CodeGroup>
  ```txt Net Worth Formula theme={null}
  Net Worth = Tradable Balance
            + Positions Value
            + Open Orders Value

  Example:
  = $1,125.50 (tradable)
  + $2,450.25 (positions)
  + $325.00 (orders)
  = $3,900.75 total
  ```

  ```txt ROI Calculation theme={null}
  ROI = (Current Value - Initial Deposits) / Initial Deposits × 100

  Example:
  Initial deposit: $3,500
  Current value: $3,900.75
  Profit: $400.75
  ROI: +11.4%
  ```
</CodeGroup>

## Performance Tracking

<AccordionGroup>
  <Accordion title="Daily Review">
    Check your portfolio daily to:

    * Review position P\&L changes
    * Monitor limit order fills
    * Identify winners and losers
    * Adjust positions based on new info
    * Take profits on big winners

    <Tip>
      Set a daily routine: Morning check before markets heat up, evening check to plan tomorrow's trades.
    </Tip>
  </Accordion>

  <Accordion title="Weekly Analysis">
    Once per week, analyze:

    * Overall portfolio ROI
    * Best and worst trades
    * Win rate (% of profitable trades)
    * Average profit per trade
    * Category performance (politics vs sports etc)

    Learn from both winners and losers to improve your strategy.
  </Accordion>

  <Accordion title="Position Sizing">
    Manage risk with proper position sizing:

    * **Small positions** (\< 5% of portfolio) - High-risk speculative trades
    * **Medium positions** (5-10%) - Standard conviction trades
    * **Large positions** (10-20%) - High-conviction value plays
    * **Never** more than 20% in one position

    <Warning>
      Diversification is crucial. Never put all funds in one market, even if you're very confident. Markets can surprise you.
    </Warning>
  </Accordion>

  <Accordion title="Risk Management">
    Protect your capital with discipline:

    * **Stop-losses** - Close positions down X% (e.g., -15%)
    * **Profit targets** - Take profits at Y% (e.g., +25%)
    * **Time limits** - Exit if market doesn't move in Z days
    * **Max drawdown** - Stop trading if down more than W% (e.g., -30%)

    <Info>
      Professional traders have rules and stick to them. Emotional decisions lead to losses. Set rules when calm, follow them when stressed.
    </Info>
  </Accordion>
</AccordionGroup>

## Trade History

View complete transaction history from **Portfolio** → **History** tab:

### What's Recorded

* All executed trades (buys and sells)
* Number of shares and execution price
* Total value
* Timestamps

<Note>
  History helps with:

  * Tax reporting (capital gains/losses)
  * Performance analysis
  * Verifying executions
  * Dispute resolution
</Note>

## Best Practices

<CardGroup cols="2">
  <Card title="Regular Reviews" icon="calendar-check">
    Check portfolio daily. Markets move fast - stay informed on your positions and adjust as needed.
  </Card>

  <Card title="Take Profits" icon="sack-dollar">
    Don't get greedy. When you have solid gains (20%+), consider taking partial profits to lock in success.
  </Card>

  <Card title="Cut Losses" icon="scissors">
    Bad trades happen. Cut losses quickly (10-15% down) rather than hoping for recovery. Capital preservation is key.
  </Card>

  <Card title="Diversify" icon="chart-scatter">
    Spread risk across markets, categories, and timeframes. Never go all-in on one outcome.
  </Card>
</CardGroup>

<Warning>
  Past performance doesn't guarantee future results. Markets are probabilistic - even good trades can lose. Focus on making +EV decisions over many trades, not winning every single trade.
</Warning>
