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).

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.

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.