# List Polymarket wallet positions (https://docs.predictorsdk.com/api-reference/listPolymarketWalletPositions)

Returns the current Polymarket positions for a wallet. The upstream source is Polymarket Data API v2; this public route keeps its existing response shape. Accepts either a wallet `address` (proxy address only — see note below) or a Polymarket `username`. Exactly one of the two must be supplied — passing both returns `400`.

v1 surfaces a minimal field set so the endpoint scaffolding can be verified end-to-end: `condition_id` (which market), `outcome` (which side), and `shares` (how much). Title/slug, avg/current price, PnL (`cash_pnl`, `realized_pnl`), `redeemable`/`mergeable` flags, and event metadata will be added in follow-ups.

`pagination.total` is always `null` because the upstream Data API does not return a total count and this route does not walk the pages to compute one (it published `0` until 2026-10-09, which read as an empty wallet beside a page of positions); `0` only ever means an empty result on the routes that count. Rely on `has_more` + `next_cursor` to paginate.

**EOA inputs are not auto-resolved on this endpoint.** Unlike `/v1/polymarket/wallet`, this endpoint does not perform the EOA→proxy CREATE2 resolution. Callers with a signer EOA should call `/v1/polymarket/wallet` first to resolve the proxy, then pass the returned `address`. Passing an EOA directly will return an empty `data` array.

Parameters:

- `address` (query, optional): string. Polymarket proxy wallet address.
- `username` (query, optional): string. Polymarket display name to resolve to a proxy wallet.
- `limit` (query, optional): integer, 1–100, default 50. Number of items requested for the first page.
- `cursor` (query, optional): string. Opaque cursor from a previous response's `pagination.next_cursor`.

Response schemas and examples: https://docs.predictorsdk.com/openapi.yaml