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

# Monitor Positions

> Read a live Hedge's P&L, accrued carry, and margin.

Once a Hedge fills, it becomes a live position. Two read endpoints cover monitoring: `GET /positions` for per-position detail, and `GET /account` for the aggregate picture across everything you hold.

## Positions

`GET /positions` returns your open positions, aggregated per side (one line each for buy and sell).

```bash theme={null}
curl "$BASE_URL/positions" \
  -H "Authorization: Bearer $MARKS_API_KEY"
```

Each line breaks the position down into its price and its carry:

| Field                        | Description                                                             |
| ---------------------------- | ----------------------------------------------------------------------- |
| `entry_price` / `mark_price` | The rate you opened at, and the current rate.                           |
| `size_usd`                   | Position notional.                                                      |
| `collateral_usdc`            | Margin posted.                                                          |
| `gross_pnl_usd`              | Price P\&L only, before carry (mark-to-market).                         |
| `accrued_carry_usd`          | Carry accrued since open, signed (positive earned, negative paid).      |
| `net_pnl_usd`                | Net of carry = gross P\&L + accrued carry.                              |
| `closing_fee_usd`            | The platform fee to exit the full size.                                 |
| `net_margin_usd`             | What you'd reclaim if you closed now = margin + net P\&L − closing fee. |
| `maturity_at`                | Settlement date.                                                        |

The key line to watch is `net_margin_usd` - it's what closing right now would return to your balance.

## Account

`GET /account` rolls everything up into one summary: free balance, margin in use, total exposure, and unrealized P\&L.

```bash theme={null}
curl "$BASE_URL/account" \
  -H "Authorization: Bearer $MARKS_API_KEY"
```

| Field                    | Description                                                           |
| ------------------------ | --------------------------------------------------------------------- |
| `balance_usdc`           | Free, spendable USDC (excludes locked margin and unrealized P\&L).    |
| `margin_used_usdc`       | Collateral locked across open positions.                              |
| `exposure_usd`           | Total open notional.                                                  |
| `unrealized_pnl_usd`     | Net mark-to-market across all positions (price P\&L + accrued carry). |
| `open_positions`         | Number of open positions.                                             |
| `max_exposure_usd`       | Your aggregate exposure cap.                                          |
| `available_exposure_usd` | Remaining exposure you can open now = cap − exposure.                 |

Use `available_exposure_usd` before opening or adding to confirm you have the headroom; an open that would exceed the cap returns `400 exposure_exceeded`.