Market Positions & P&L

Returns all holder positions for a market with per-holder P&L breakdown. Results are grouped by outcome token, with each holder’s cash P&L, realized P&L, total P&L, average entry price, and current value.

Accepts a condition ID (0x-prefixed) or market slug. Supports sorting by P&L and filtering by position status (open/closed/all).

When includeTrades=true, this endpoint is rate limited to 60 requests per minute per key (separate from your standard rate limit).

GET /v1/markets/{id}/positions

Market positions & P&L

cURL

curl --request GET \
  --url https://api.polynode.dev/v1/markets/{id}/positions \
  --header 'x-api-key: <api-key>'

200

{
  "condition_id": "0x895e01dbf3e6a33cd9a44ca0f8cdb5df1bd2b0b6ebed5300d28f8da7145145e4",
  "market_title": "Will Donald Trump win the 2028 Republican presidential nomination?",
  "slug": "will-donald-trump-win-the-2028-republican-presidential-nomination",
  "outcome_names": [
    "Yes",
    "No"
  ],
  "outcomes": [
    {
      "token": "3039641309958397001906153616677074061284510636203465131156925998487819889437",
      "positions": [
        {
          "proxyWallet": "0xa5ef39c3d3e10d0b270233af41cac69796b12966",
          "name": "",
          "outcome": "No",
          "outcomeIndex": 1,
          "size": 1735573.72,
          "avgPrice": 0,
          "currPrice": 0.9835,
          "currentValue": 1706936.75,
          "cashPnl": 1706936.75,
          "realizedPnl": 0,
          "totalPnl": 1706936.75
        },
        {
          "proxyWallet": "0xc2e7800b5af46e6093872b177b7a5e7f0563be51",
          "name": "beachboy4",
          "outcome": "Yes",
          "outcomeIndex": 0,
          "size": 248651.26,
          "avgPrice": 0.040276,
          "currPrice": 0.0165,
          "currentValue": 4102.75,
          "cashPnl": -5911.93,
          "realizedPnl": 0,
          "totalPnl": -5911.93,
          "firstTradeAt": 1753016057,
          "lastTradeAt": 1765034355
        }
      ]
    }
  ]
}

Authorizations

x-api-key · string · header · required

Path Parameters

id · string · required

Condition ID (0x-prefixed) or market slug

Query Parameters

limit · integer · default: 50

Maximum holders per outcome token (default 50, max 500)

Required range: 1 <= x <= 500

offset · integer · default: 0

Pagination offset (default 0)

Required range: x >= 0

sortBy · enum<string> · default: TOTAL_PNL

Sort holders by field

Available options: TOKENS, CASH_PNL, REALIZED_PNL, TOTAL_PNL

sortDirection · enum<string> · default: DESC

Sort direction

Available options: ASC, DESC

status · enum<string> · default: ALL

Filter by position status

Available options: OPEN, CLOSED, ALL

includeTrades · boolean · default: false

Enrich each position with firstTradeAt and lastTradeAt timestamps. Adds one upstream call per holder, so responses will be slower. Default false. Rate limited to 60 requests per minute per key (separate from your standard rate limit).

user · string

Filter to specific wallet address(es). Accepts a single address or multiple comma-separated addresses (max 20). Returns only those wallets' positions in this market.

Response

200

application/json

Market positions grouped by outcome token

Holder positions for a market, grouped by outcome token.

condition_id · string · required

Market condition ID.

outcomes · object[] · required

Array of outcome tokens, each containing a list of holder positions.

Show child attributes

market_title · string

Market title (enriched by PolyNode).

slug · string

Market slug (enriched by PolyNode).

outcome_names · string[]

Outcome names (e.g. ["Yes", "No"]).