v9

latestOpenAPI 3.0.0raw.githubusercontent.com2026-06-2491679.8 KB

Orders & Positions

Fetch Positions

List the open positions held by address across Polymarket, Opinion, and Limitless. Each position carries the market, outcome, share count, and average entry price.

Mark-to-market fields (current_price, current_value, unrealized_pnl) are reserved for a future release and currently return null.

get/v0/user/{address}/positions

Path parameters

addressstring required

EVM wallet address.

Response

Positions list.

venue'polymarket' | 'opinion' | 'limitless' required

Venue the position is held on. Defaults to polymarket for tokens whose source venue could not be inferred.

sharesnumber required

Outcome shares held -- the ERC-1155, Opinion-native, or Limitless token balance held by the PMXT PreFundedEscrow on behalf of the wallet.

current_pricenumber nullable

Current mark price in probability units [0, 1]. Always null in this release -- server-side orderbook mark-to-market is not yet batched (even with with_mtm=true).

current_valuenumber nullable

Current mark-to-market value in USDC dollars (shares * current_price). Always null in this release for the same reason as current_price.

outcome_labelstring nullable

Human-readable outcome name (e.g. Yes), enriched from the user's recorded buy fills. null when the user has no fill history for this token in the operator DB.

entry_pricenumber nullable

Cost-basis approximation: sum(buy USDC) / sum(buy shares) across all of the user's buy fills for this token, in USDC-per-share. Ignores sells -- lot-level matching is not yet implemented. null when there are no recorded buy fills.

realized_pnlnumber nullable

Always null in this release. Derivation requires lot-level matching of sell fills, which is not yet implemented.