[Backend] — Prediction P&L Calculation Endpoint

[Olowodarey]

Labels: backend, enhancement, predictions, analytics

Problem

Users cannot see realized and unrealized profit/loss for their positions, so they lack a clear view of performance.

Requirements

1. Compute realized P&L from settled predictions.
2. Compute unrealized P&L from open positions at current odds.
3. Add GET /predictions/pnl returning both, with a time filter.
4. Support per-market and aggregate breakdowns.

Acceptance Criteria

• Realized and unrealized P&L are computed correctly.
• The endpoint supports time filtering and breakdowns.
• Aggregate equals the sum of per-market values.
• Tests cover realized, unrealized, and aggregation math.

Files

backend/src/predictions/predictions.service.ts, backend/src/predictions/predictions.controller.ts, backend/src/predictions/dto

[Jess52487]

@Jess52487 has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

Please assign me to work on this issue

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Jess52487 to this issue.

[Richkid2]

@Richkid2 has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

Hello, you can consider me to fix this issue

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Richkid2 to this issue.

[KorexOnchain]

@KorexOnchain has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

I'll love to hop on this thanks

ℹ️ Repo Maintainers: To accept this application, review their application or assign @KorexOnchain to this issue.

[Awointa]

@Awointa has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

I'd like to work on this issue. I'll add P&L calculation to predictions.service.ts computing realized P&L from settled predictions and unrealized P&L from open positions at current odds. I'll add GET /predictions/pnl endpoint in the controller supporting time filtering and per-market/aggregate breakdowns. Tests will verify realized, unrealized, and aggregation math. Branch: feature/prediction-pnl-endpoint.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Awointa to this issue.

[Mkalbani]

@Mkalbani has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

Hi maintainers, can I work on this. I've worked on a similar work. Thank you.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Mkalbani to this issue.

[drips-wave]

Congratulations, @Awointa! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on July 30, 2026.

🧑‍💻 @Awointa: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊