liujiarui0918/alphamesh/pnl-explain

PnL Explanation

Description

Explains profit and loss composition and attribution for paper accounts using engine-calculated breakdowns.

Triggers

• "Why is my PnL down this week?"
• "Break down my paper account PnL"

Steps

1. Obtain the paper account_id (and optional symbol filter).
2. Call paper_pnl for aggregate and per-symbol PnL figures where available.
3. Call explain_pnl for realized vs unrealized decomposition and narrative detail.
4. Tie changes to positions, fees, and marks—clearly labeling estimates when prices are stale.

Tools Used

• explain_pnl: Decompose realized and unrealized PnL with per-position context.
• paper_pnl: Query paper account-level PnL summaries for quick numeric grounding.

Example Interaction

User: Explain my PnL on account paper-123. Agent: I will call paper_pnl for the headline numbers, then explain_pnl with account_id paper-123 to break down realized vs unrealized drivers.

Notes

• Attribution is based on simulated/paper state; live trading may differ due to fills and fees.