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

100 credits per API call

Current open positions held by a wallet — one row per outcome token, with unrealised PnL, current value, lifetime cost basis, and the parent market's question, slug and outcome metadata. Useful for "what's in my portfolio right now" views and per-market drill-downs.

Platform support

• Polymarket only. Kalshi wallets return 400.

Filtering, sorting and pagination

• market scopes the response to a comma-separated list of

  condition ids (0x + 64 hex), up to 50 entries.

• eventId scopes the response to a comma-separated list of

  Polymarket numeric event ids, up to 50 entries. Mutually exclusive with
  market — passing both returns 400.

• sizeThreshold filters out positions smaller than the given

  size. Defaults to 1; pass 0 to include dust.

• redeemable=true returns positions on resolved markets that

  the wallet has won but has not yet redeemed. mergeable=true
  returns positions eligible for merging back to USDC. Both default to
  false.

• sortBy accepts CURRENT, INITIAL, TOKENS, CASHPNL, PERCENTPNL, TITLE, RESOLVING, PRICE, AVGPRICE. Defaults to TOKENS. Combine with sortDirection (ASC / DESC, defaults to DESC).
• title filters by a substring of the market question.
• Pagination is offset-based — limit (1..500, default 100) and offset (0..10000, default 0).

Other notes

• address is normalised to lowercase before being echoed in the

  response (every row's proxyWallet).

• negativeRisk indicates whether the parent market is part of

  Polymarket's negative-risk grouping (e.g. multi-candidate winner-take-all
  markets).