Market Positions (Condition)

Returns wallet-position rows for every outcome token in a market condition. Use sort=amount to fetch the largest current holders first across all outcomes in the condition.

Request

GET /v3/markets/condition/{condition_id}/positions

Path parameters

Parameter	Type	Description
`condition_id`	string	Market condition ID (`0x` + 64 hex characters). The response includes positions for every outcome token in this condition.

Query parameters

Parameter	Type	Default	Description
`sort`	string	`pnl`	Sort order. One of `pnl` (realized P&L), `amount` (current shares held), or `volume` (total bought).
`limit`	integer	100	Rows per page. Requests are capped by API key tier: Starter `300`, Growth `1000`, Enterprise `1000`.
`offset`	integer	0	Number of rows to skip for pagination.

If limit is above your tier cap, PolyNode normalizes it to the maximum allowed value instead of rejecting the request. Every response includes the applied limit, plus rows_returned, offset, and has_more.

Sorting

Use sort=amount when you need the largest current holders for a condition. The sort is descending, so the first rows are the wallets with the highest current amount across the condition’s outcome tokens.

Example

curl -H "x-api-key: $POLYNODE_API_KEY" \
  "https://api.polynode.dev/v3/markets/condition/0x713641f745d71f6ec61f906237ffca3c8583f251e49384429a63ceb0ccdb2d37/positions?sort=amount&limit=1&offset=0"

Example response

{
  "data": [
    {
      "amount": "6660546928621",
      "avg_price": null,
      "realized_pnl": "0",
      "token_id": "1770840559776249239623005379825945674336282130390798724203946923853499387834",
      "total_bought": "0",
      "user": "0xa5ef39c3d3e10d0b270233af41cac69796b12966"
    }
  ],
  "elapsed_ms": 3,
  "has_more": true,
  "limit": 1,
  "offset": 0,
  "rows_returned": 1
}

Response columns

Column	Type	Description
`user`	string	Wallet address (lowercased)
`token_id`	string	Outcome token this row covers (each condition has multiple outcomes; a wallet can appear once per outcome it has touched)
`amount`	string	Current shares held in 6-decimal token units (`0` if the wallet has exited this outcome)
`avg_price`	string \| null	Average entry price in 6-decimal USDC units (`500000` = $0.50). May be `null` when cost basis is not available.
`realized_pnl`	string	Realized P&L on the closed portion of the position in 6-decimal USDC units
`total_bought`	string	Cumulative purchase cost basis in 6-decimal USDC units

Overview

V3 Data API

Wallet P&L

Wallet Activity

Credits

Identity

Fees

Combos

Rewards

Markets & Search

Orderbook

Leaderboard & Tags

Builders

Polymarket Profiles

Global

Tokens

Perps

Perps Market Data

Perps Wallets

Perps Analytics

Perps On-Chain

Perps Streaming

Crypto

Sports

BYOL

Backtesting

Market Card

System

Search & Context

Onchain V2 (legacy)

Market Positions (Condition)

Request

Path parameters

Query parameters

Sorting

Example

Example response

Response columns

​Request

​Path parameters

​Query parameters

​Sorting

​Example

​Example response

​Response columns

Request

Path parameters

Query parameters

Sorting

Example

Example response

Response columns