Sign in
Core

Get positions for a market

Returns positions for a given market (condition_id), grouped by outcome token, with profile data, PnL breakdown, and current pricing.

get/v1/market-positions

Request

  • Base URL: https://data-api.polymarket.com
  • URL: https://data-api.polymarket.com/v1/market-positions
  • Auth: none declared

Query parameters

marketstring required

0x-prefixed 64-hex string

Example:0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917

The condition ID of the market to query positions for

userstring

User Profile Address (0x-prefixed, 40 hex chars)

Example:0x56687bf447db6ffa42ffe2204a05edaa20f55839

Filter to a single user by proxy wallet address

status'OPEN' | 'CLOSED' | 'ALL'

Filter positions by status.

  • OPEN — Only positions with size > 0.01
  • CLOSED — Only positions with size <= 0.01
  • ALL — All positions regardless of size
sortBy'TOKENS' | 'CASH_PNL' | 'REALIZED_PNL' | 'TOTAL_PNL'

Sort positions by:

  • TOKENS — Position size (number of tokens)
  • CASH_PNL — Unrealized cash PnL
  • REALIZED_PNL — Realized PnL
  • TOTAL_PNL — Total PnL (cash_pnl + realized_pnl)
sortDirection'ASC' | 'DESC'
limitinteger

Max number of positions to return per outcome token

offsetinteger

Pagination offset per outcome token

Response

Success

tokenstring

The outcome token asset ID

Example response

[
  {
    "positions": [
      {
        "proxyWallet": "0x56687bf447db6ffa42ffe2204a05edaa20f55839",
        "conditionId": "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917"
      }
    ]
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.