GET /api/v1/predictions/leaderboard/

Aggregate prediction market P&L per user from the VaultTransaction ledger, including unrealized value of open positions priced by the LSMR engine. Public endpoint — the leaderboard is a community feature, no auth required.

Methodology: total_in = SUM(amount) for direction='in' and tx_type in {prediction_sell, prediction_payout, prediction_refund} total_out = SUM(amount) for direction='out' and tx_type = 'prediction_buy' unrealized = LSMR sell value of all open positions (shares > 0, market open) net_pnl = total_in + unrealized - total_out

Users are ranked by net_pnl descending. Only users who have at least one prediction_buy VaultTransaction are included (i.e. excludes the MM user and purely passive accounts).

Query params: limit — max entries to return (default: 50, max: 200)

Response: { "results": [ { "username": "alice", "total_in": "1200.00", "total_out": "800.00", "unrealized": "350.00", "net_pnl": "+750.00" }, ... ], "count": <int> }