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

# LP Risk & Reward

> LP economics: earn 70% of trading fees (0.05% per trade) plus liquidation penalties (0.3%), risk exposure to aggregate trader PnL, scenario analysis for pool returns across market conditions.

The Nile Markets liquidity pool is the counterparty to every trader position. LPs deposit USDC and receive vault shares representing their proportional ownership. This page explains what drives LP returns — both positive and negative.

## What LPs Earn

<Columns cols={3}>
  <Card title="Trading Fees" icon="receipt">
    0.05% of notional collected on every position open, increase, settlement, close, and reduction. The pool receives 70% of all trading fees (the remaining 30% goes to the protocol treasury).
  </Card>

  <Card title="Liquidation Penalties" icon="gavel">
    0.30% of notional collected when underwater positions are liquidated, on top of the trading fee. The pool's 70% share of liquidation penalties adds to LP returns.
  </Card>

  <Card title="Trader Losses" icon="chart-line">
    When traders lose money, their losses flow directly to the pool as profit. In aggregate, most retail traders lose more than they win, creating a structural edge for LPs.
  </Card>
</Columns>

## What LPs Risk

<Columns cols={3}>
  <Card title="Trader Profits" icon="arrow-trend-up">
    When traders are net profitable, their gains come from the pool. A sustained period of trader wins reduces pool equity and LP share value.
  </Card>

  <Card title="Bad Debt" icon="triangle-exclamation">
    In extreme market moves, a trader's loss can exceed their locked margin. The excess (bad debt) is absorbed by the pool. This is rare but possible during fast-moving markets or oracle delays.
  </Card>

  <Card title="Withdrawal Restrictions" icon="lock">
    When pool utilization is high (above 80%), LP withdrawals are restricted. Your capital may be temporarily locked until positions close and utilization decreases.
  </Card>
</Columns>

<Warning>
  The pool is a zero-sum counterparty to all trader positions. When traders collectively profit, the pool loses an equal amount. LP returns are not guaranteed — they depend on the mix of trading fees earned versus trader profits paid out.
</Warning>

## Scenario Analysis

The following scenarios illustrate LP economics over a hypothetical month with \$10M in pool equity and \$500M in monthly trading volume.

<Tabs>
  <Tab title="Conservative (Traders Lose 70%)">
    | Metric                        | Value         |
    | ----------------------------- | ------------- |
    | Monthly trading volume        | \$500,000,000 |
    | Trading fees (0.05% x volume) | \$250,000     |
    | Pool's share (70%)            | \$175,000     |
    | Liquidation penalties (est.)  | \$50,000      |
    | Net trader losses to pool     | \$300,000     |
    | **Total pool income**         | **\$525,000** |
    | Monthly return on \$10M       | **5.25%**     |

    This is the most favorable scenario for LPs. Fees provide a base return, and net trader losses significantly boost pool equity.
  </Tab>

  <Tab title="Balanced (50/50 Win Rate)">
    | Metric                        | Value         |
    | ----------------------------- | ------------- |
    | Monthly trading volume        | \$500,000,000 |
    | Trading fees (0.05% x volume) | \$250,000     |
    | Pool's share (70%)            | \$175,000     |
    | Liquidation penalties (est.)  | \$25,000      |
    | Net trader PnL to pool        | \$0           |
    | **Total pool income**         | **\$200,000** |
    | Monthly return on \$10M       | **2.00%**     |

    When trader wins and losses balance out, the pool's return comes purely from fees. This is the breakeven scenario for directional risk — fees are the LP's edge.
  </Tab>

  <Tab title="Adverse (Traders Win 70%)">
    | Metric                        | Value          |
    | ----------------------------- | -------------- |
    | Monthly trading volume        | \$500,000,000  |
    | Trading fees (0.05% x volume) | \$250,000      |
    | Pool's share (70%)            | \$175,000      |
    | Liquidation penalties (est.)  | \$10,000       |
    | Net trader profits from pool  | -\$300,000     |
    | **Total pool income**         | **-\$115,000** |
    | Monthly return on \$10M       | **-1.15%**     |

    In this scenario, trader profits exceed fee income. Pool equity declines and LP share value decreases. However, the loss is partially offset by the fee revenue.
  </Tab>
</Tabs>

<Info>
  These scenarios are illustrative. Actual results depend on trading volume, the distribution of trader PnL, liquidation frequency, and position sizes. The protocol's risk management (exposure caps, mode escalation, liquidation) is designed to limit extreme adverse scenarios.
</Info>

## Worst-Case Scenario

<Accordion title="What if all positions are directionally aligned and move against the pool?">
  ### Setup

  * Pool equity: \$1,000,000 USDC
  * All positions are LONG with maximum leverage (50x, 2% margin)
  * Gross notional at 80% utilization cap: \$800,000

  ### 5% adverse move (EUR/USD rises 5%)

  * Pool loss = gross notional × price move = \$800,000 × 5% = \$40,000
  * Pool equity after: \$1,000,000 - \$40,000 = \$960,000
  * Share price impact: -4.0%

  ### Why this is bounded

  * Exposure caps limit net directional notional (not just gross), so a mixed book reduces actual directional risk
  * Maintenance margin (1%) triggers liquidation well before losses reach pool equity
  * At 50x leverage, a 1% adverse move puts max-leverage positions at the liquidation threshold
  * The keeper liquidates these positions, collecting the 0.30% liquidation penalty and capping loss at locked margin per position

  In practice, the combination of the utilization cap (80%), exposure caps, and liquidation at 1% adverse move for max-leverage positions means the pool's actual maximum loss from a single price move is significantly less than the theoretical gross notional exposure.
</Accordion>

## How Share Price Reflects Returns

LP returns are reflected in the vault's share price. When the pool earns fees or absorbs trader losses, pool equity increases, and the share price rises. When the pool pays trader profits, equity decreases, and the share price falls.

Share price formula:

```
sharePrice = totalAssets / totalShares
```

A simple example:

* LP deposits 1,000 USDC when share price is 1.00 → receives 1,000 shares
* Pool earns 50 USDC in fees → share price rises to \~1.05
* LP redeems 1,000 shares → receives \~1,050 USDC

For the full mechanics, see [Share Price Calculation](/deploy/share-price).

## Risk Mitigation

The protocol includes several mechanisms that protect LP capital:

<Steps>
  <Step title="Exposure Caps">
    The pool's net directional exposure is capped based on pool equity and a stress-adjusted formula. This limits how much the pool can lose from a single directional move.
  </Step>

  <Step title="Mode Escalation">
    If oracle issues or extreme conditions are detected, the protocol can transition to Degraded or Reduce-Only mode, blocking new position openings while allowing existing ones to close. This prevents risk from growing during disruptions.
  </Step>

  <Step title="Liquidation System">
    Underwater positions are liquidated before losses exceed their locked margin. The liquidation penalty provides additional revenue to the pool. The keeper service automates this process.
  </Step>

  <Step title="Per-Position and Per-Account Limits">
    No single position or trader can dominate the pool's exposure. Caps ensure diversification across many positions.
  </Step>

  <Step title="Utilization Cap">
    A maximum utilization of 80% ensures a 20% liquidity buffer remains in the pool at all times, providing headroom for payouts and operational costs.
  </Step>
</Steps>

## FAQs

<AccordionGroup>
  <Accordion title="Can LPs lose their entire deposit?">
    In theory, yes — if trader profits and bad debt persistently exceed fee income, pool equity can approach zero. In practice, the combination of exposure caps, liquidation, and mode escalation makes this extremely unlikely. The pool would need to sustain massive, sustained losses beyond what the risk parameters allow.
  </Accordion>

  <Accordion title="How long should I provide liquidity?">
    LP returns tend to be smoother over longer periods as fee income accumulates and trader wins/losses balance out. Short-term LP positions are more exposed to individual trader outcomes.
  </Accordion>

  <Accordion title="Is providing liquidity like being a market maker?">
    Similar in concept — you're taking the other side of trades and earning fees. The key difference is that LPs in the vault share exposure collectively, while a traditional market maker manages their own book. You don't need to actively manage positions.
  </Accordion>
</AccordionGroup>

## Next Steps

<Columns cols={3}>
  <Card title="Depositing & Withdrawing" icon="money-bill-transfer" href="/deploy/depositing-withdrawing">
    Step-by-step guide for LP operations
  </Card>

  <Card title="Share Price" icon="chart-line" href="/deploy/share-price">
    Detailed share price mechanics
  </Card>

  <Card title="Pool Utilization" icon="gauge-high" href="/deploy/pool-utilization">
    Utilization caps and withdrawal restrictions
  </Card>
</Columns>