Docs
⌘ K

User Positions

GET/v1/polymarket/users/positions

Returns a user’s positions with PNL breakdown per outcome token. Each row is one token’s cumulative position: cost basis, realized PNL, net shares held, average entry price, and current market price.

Use closed=false for positions on live markets, or closed=true for resolved markets.

Query Parameters

ParameterDescriptionValue
user
string
  • Accepted pattern: ^(0[xX])?[0-9a-fA-F]{40}$
  • Format: evm-address
Required
token_id
string
    condition_id
    string
      market_slug
      string
        closed
        boolean
          sort_by
          string
          • Default value: position_value
          • Accepted values: position_value, realized_pnl, unrealized_pnl, total_pnl, pnl_pct, transactions, avg_price, current_price
          position_value
          limit
          integer

          Number of items* returned in a single request.
          *Plan restricted.

          • Default value: 10
          • Minimum value: 1
          • Maximum value: 1000
          page
          integer

          Page number to fetch.
          Empty data array signifies end of results.

          • Default value: 1
          • Minimum value: 1
          • Maximum value: 767465558638

          Potential Responses

          StatusDescription
          200

          Successful Response

          400

          Client side error

          401

          Authentication failed

          403

          Forbidden

          404

          Not found

          500

          Server side error