| name | portfolio |
| description | Review and manage the full trading portfolio -- positions, PnL, balance, and margin health. |
Portfolio Management
A systematic approach to reviewing and managing all open positions, balance, and overall portfolio health.
Workflow
1. Check All Open Positions
Call get_positions to retrieve every open position. For each position, note:
- Symbol
- Side (long/short)
- Size
- Entry price
- Current mark price
- Unrealised PnL
- Leverage
- Take-profit and stop-loss levels
2. Review Unrealised PnL
Assess each position:
- Winning positions: those with positive unrealised PnL
- Losing positions: those with negative unrealised PnL
- At-risk positions: those approaching their stop-loss
Calculate total unrealised PnL across all positions.
3. Check Balance and Margin Usage
Call get_balance to get:
- Total equity
- Available balance (free margin)
- Used margin
- Unrealised PnL
Calculate margin utilization:
margin_utilization = used_margin / total_equity * 100
Flag if margin utilization exceeds 70% -- this indicates high risk.
4. Identify Positions to Adjust
Review positions that may need action:
- Close: positions with unrealised loss exceeding 2% of total equity
- Tighten SL: winning positions where SL can be moved to breakeven
- Take partial profit: positions with unrealised gain exceeding 3% of equity
- No TP/SL set: positions missing take-profit or stop-loss (set them immediately)
For any adjustment, use set_tp_sl to update levels or place_order to close.
5. Portfolio Health Summary
Present a summary table:
Portfolio Summary
-----------------
Total Equity: $X,XXX.XX
Available Margin: $X,XXX.XX
Used Margin: $X,XXX.XX
Margin Utilization: XX.X%
Open Positions: X
Total Unrealised PnL: +/- $X,XXX.XX
Winning / Losing: X / X
Followed by a per-position breakdown and any recommended actions.
