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

# Positions

> Managing your active and pending positions

This guide covers how to view and manage your active trading positions and pending trade requests.

***

## Position Types

<CardGroup cols={2}>
  <Card title="Active Positions" icon="play">
    Matched trades that are live and tracking P\&L against oracle prices.
  </Card>

  <Card title="Pending Trades" icon="clock">
    Trade requests waiting to be matched with liquidity.
  </Card>
</CardGroup>

***

## Active Positions

### Viewing Active Positions

Find your active positions on the **Trade** page, in the positions panel below the order form.

### Position Information

Each active position displays:

| Field             | Description                        |
| ----------------- | ---------------------------------- |
| Pair              | Trading pair (e.g., BTC/USDC)      |
| Direction         | Long or Short indicator            |
| Size              | Position size in USD               |
| Leverage          | Leverage multiplier                |
| Entry Price       | Oracle price when position opened  |
| Current Price     | Real-time oracle price             |
| Unrealized P\&L   | Current profit/loss (updates live) |
| Liquidation Price | Price that triggers liquidation    |
| Stop-Loss         | Your stop-loss level (if set)      |
| Take-Profit       | Your take-profit level (if set)    |
| Duration          | Time position has been open        |

### P\&L Display

Unrealized P\&L is color-coded:

* **Green**: Position is profitable
* **Red**: Position is at a loss
* **Gray**: Break-even (±0.1%)

The percentage shown is return on collateral:

```
Return % = (P&L / Collateral) × 100
```

***

## Managing Active Positions

### Closing a Position

<Steps>
  <Step title="Locate Position">
    Find the position you want to close in your active positions list.
  </Step>

  <Step title="Click Close">Click the "Close" button on the position row.</Step>

  <Step title="Review">
    Confirm the closing details: - Final P\&L - Fees - Amount to receive
  </Step>

  <Step title="Confirm">Approve the transaction in your wallet.</Step>
</Steps>

### Modifying Stop-Loss / Take-Profit

<Steps>
  <Step title="Select Position">Click on the position to expand details.</Step>
  <Step title="Edit SL/TP">Click "Edit" next to Stop-Loss or Take-Profit.</Step>
  <Step title="Enter New Level">Input your new price level.</Step>
  <Step title="Confirm">Sign the transaction to update.</Step>
</Steps>

<Note>Modifying SL/TP requires a small gas fee for the on-chain update.</Note>

***

## Pending Trades

### What Are Pending Trades?

When you submit a trade request, it enters a pending state while waiting for a matcher to provide liquidity.

### Viewing Pending Trades

Navigate to **Pending Trades** in the sidebar to see all your pending requests.

### Pending Trade Information

| Field         | Description                  |
| ------------- | ---------------------------- |
| Pair          | Requested trading pair       |
| Direction     | Long or Short                |
| Collateral    | Amount you're putting up     |
| Leverage      | Requested leverage           |
| Size          | Calculated position size     |
| Stop-Loss     | Pre-set stop-loss (if any)   |
| Take-Profit   | Pre-set take-profit (if any) |
| Time in Queue | How long it's been pending   |
| Status        | Waiting / Partially Matched  |

### Pending Trade Status

| Status            | Meaning                               |
| ----------------- | ------------------------------------- |
| Waiting           | In queue, no liquidity matched yet    |
| Partially Matched | Some liquidity allocated, more needed |
| Matching          | Currently being processed             |

***

## Managing Pending Trades

### Cancelling a Pending Trade

If your trade hasn't been matched yet:

<Steps>
  <Step title="Find Pending Trade">
    Locate the trade in your Pending Trades list.
  </Step>

  <Step title="Click Cancel">Click the "Cancel" button.</Step>
  <Step title="Confirm">Approve the cancellation transaction.</Step>

  <Step title="Funds Returned">
    Your collateral returns to your trading balance.
  </Step>
</Steps>

<Warning>
  Once a trade is matched, you cannot cancel it. You must close the active
  position instead.
</Warning>

### Matching Time Expectations

| Position Size        | Typical Wait |
| -------------------- | ------------ |
| Small (\< \$500)     | 1-5 minutes  |
| Medium ($500-$5,000) | 5-15 minutes |
| Large (> \$5,000)    | 15+ minutes  |

Factors affecting matching:

* Market conditions
* Available matcher liquidity
* Pair popularity
* Time of day

***

## Position Cards vs. Table View

### Card View

Compact cards showing key info:

* Pair and direction
* P\&L prominently displayed
* Quick action buttons

Best for: Mobile, quick monitoring

### Table View

Detailed table with all columns:

* Full information at a glance
* Easy comparison between positions
* Sortable columns

Best for: Desktop, detailed analysis

Toggle between views using the view selector button.

***

## Position Alerts

### Setting Alerts

Configure notifications for your positions:

| Alert Type          | Trigger                           |
| ------------------- | --------------------------------- |
| Price Alert         | Asset reaches specified price     |
| P\&L Alert          | Position P\&L reaches threshold   |
| Liquidation Warning | Approaching liquidation price     |
| SL/TP Triggered     | Stop-loss or take-profit executes |

### Notification Channels

* Browser notifications
* Email (if configured)
* Discord webhooks (coming soon)

***

## Position Health

### Margin Level

Monitor how healthy your position is:

```
Margin Level = (Collateral + Unrealized P&L) / Maintenance Margin × 100%
```

| Margin Level | Status               |
| ------------ | -------------------- |
| > 150%       | Healthy (Green)      |
| 100-150%     | Caution (Yellow)     |
| \< 100%      | Danger (Red)         |
| \< 80%       | Liquidation imminent |

### Distance to Liquidation

Shows how far the current price is from your liquidation price:

```
Distance = |Current Price - Liquidation Price| / Current Price × 100%
```

***

## Multiple Positions

### Managing Several Positions

Tips for handling multiple active trades:

<AccordionGroup>
  <Accordion title="Track net exposure">
    Multiple positions in same pair can offset or compound exposure. Monitor
    your net long/short.
  </Accordion>

  <Accordion title="Use consistent sizing">
    Keep position sizes manageable so one loss doesn't wipe out several wins.
  </Accordion>

  <Accordion title="Stagger stop-losses">
    Avoid placing all stops at the same level to prevent cascade closes.
  </Accordion>

  <Accordion title="Review regularly">
    Check all positions daily, especially in volatile markets.
  </Accordion>
</AccordionGroup>

### Aggregate View

Summary stats for all your active positions:

* Total unrealized P\&L
* Total collateral at risk
* Net exposure by asset
* Total interest accruing

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="Position not showing">
    * Check if it's in Pending vs. Active - Refresh the page - Verify
      transaction confirmed - Try reconnecting wallet
  </Accordion>

  <Accordion title="Can't close position">
    * Ensure you have ETH for gas - Position may be in process of liquidation -
      Try increasing gas limit
  </Accordion>

  <Accordion title="P&L seems wrong">
    * P\&L is based on oracle price, not exchange price - Account for accumulated
      interest - Check entry price recorded
  </Accordion>

  <Accordion title="Pending trade stuck">
    * Large positions take longer to match - Consider cancelling and splitting
      into smaller trades - Check if liquidity is available for that pair
  </Accordion>
</AccordionGroup>

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Closing Trades" icon="door-closed" href="/trading/closing-trades">
    Learn more about closing positions.
  </Card>

  <Card title="Trade History" icon="clock-rotate-left" href="/features/trade-history">
    Review your past trades.
  </Card>
</CardGroup>