Docs
⌘ K

Market Positions

GET/v1/polymarket/markets/positions

Returns all user positions for a specific outcome token — a leaderboard view. Each row is one user’s cumulative position: cost basis, PNL, shares held, and current value.

For a user’s portfolio across all markets, use /v1/polymarket/positions instead.

Query Parameters

ParameterDescriptionValue
token_id
string
    		Required
    closed
    boolean
      sort_by
      string
      • Default value: position_value
      • Accepted values: position_value, realized_pnl, unrealized_pnl, total_pnl, pnl_pct, transactions, avg_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