Widgets
Positions

Positions Widget

The Positions widget displays your open positions with real-time PnL, inline SL/TP, customizable partial closes, and a shareable PnL card.

Header

The header shows Total PnL across all positions and your Balance, plus:

  • Privacy toggle (eye icon) — masks all $ amounts as ******* while keeping PnL color. Shared globally with the Account widget.
  • Partial-close settings — edit the quick-close percentages
  • Column settings — show/hide columns

Position Information

Each row displays:

FieldDescription
SymbolBase asset with a LONG/SHORT badge; leverage and margin type shown beneath
SizePosition notional in USD, with the base-asset quantity beneath
EntryAverage entry price
MarkCurrent mark price
LiqLiquidation price (yellow when set, when unavailable)
PnLUnrealized PnL in dollars, with ROE % beneath
SL/TPInline Set SL/TP control
ActionPartial-close buttons, Close, and Share PnL

Columns are individually toggleable via the column-settings menu.

PnL Display

PnL updates in real time from the mark price:

  • Dollar value (e.g. +$125.50) and ROE % (e.g. +12.5%)
  • Green for profit, red for loss
  • Total PnL in the header sums all open positions

Managing Positions

Close full position

Click Close — it places an opposite reduce-only market order for the full size. No confirmation dialog; it executes at market immediately.

Partial close

Click a percentage button (default 25% / 50% / 75%) to close that fraction as a reduce-only market order. The percentages are fully editable in the partial-close settings, and persist across sessions.

If a partial close would round up to the entire position (already at minimum lot size), the widget refuses it and asks you to use Close instead.

Set SL/TP

Use the Set SL/TP control on a row to attach a reduce-only stop-loss (STOP_MARKET) and/or take-profit (TAKE_PROFIT_MARKET) for the position. They then appear in the Open Orders widget.

Share PnL

The Share button opens a PnL share card for the position — side, leverage, ROE, entry/mark — and attributes the trade to its originating news headline when it was opened from a news card.

Position Indicators

The Liq column highlights the liquidation price in yellow when the exchange reports one. Consider adding margin or reducing size as a position approaches it.

Real-Time Updates

Positions update automatically via WebSocket, with a bounded reconcile poll on Hyperliquid and Phoenix so positions closed outside the terminal still clear within a few seconds:

  • Mark price and PnL recalculate live
  • New positions appear immediately
  • Closed positions remove automatically

Realized PnL from closing positions feeds the in-terminal Leaderboard (golden trophy in the header) under its Traders tab.

Empty State

When you have no open positions the widget shows No open positions — open a trade from Trade Entry or the command line to see it here.