/v4/data/prediction/wallets/{address}/portfolio

200 credits per API call

Aggregated portfolio summary for a single wallet. Returns position counts (open, redeemable, closed), unrealised and realised PnL, total cost basis, active notional, win rate and ROI — all computed over the requested period. Useful as the headline KPI block on a wallet detail page.

Platform support

• Polymarket only. Passing any non-EVM address returns 400.

Filtering

• period selects the lookback window for closed-position aggregates: 24h, 7d, 30d or all. Defaults to all.
• Open-position counts and activeNotional are always live (the period only affects closed-position roll-ups).

Other notes

• address is normalised to lowercase before being echoed back in the response.
• winRate is a percentage in [0, 100] (e.g. 42.5 = 42.5%). It is null when closedPositions is zero — the ratio is undefined, not zero.
• roi is realised ROI as a percentage (e.g. 23.45 = 23.45%). Computed from realised PnL over total cost basis of closed positions only — unrealised PnL is excluded. null when totalCostBasis is zero.
• redeemablePositions is the count of positions on a resolved market that the wallet has won but has not yet redeemed. Disjoint from both openPositions and closedPositions — tracked separately so the count of currently actionable positions is visible.