/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.