Sign in
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.

Changes

Changed in 3 of the 9 revisions of this API.32

  • 6784cc7c83761See the full diff
    • ●

      added the new limitless enum value to the items/venue response property for the response status 200

      response-property-enum-value-added

  • 6c1e54fea3a32See the full diff
    • ○

      api tag Orders & Positions added

      api-tag-added

    • ○

      api tag Orders & Positions (Hosted) removed

      api-tag-removed

  • d2fae12231322See the full diff
    • ●

      removed the optional property items/market_id from the response with the 200 status

      response-optional-property-removed

    • ●

      removed the optional property items/outcome_id from the response with the 200 status

      response-optional-property-removed