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
    		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