Market Positions (Token)

Get all wallets holding positions in a specific outcome token, sorted by P&L or size.

Returns all wallets that hold or have held positions in a specific outcome token.

Request

GET /v3/markets/{token_id}/positions

Query parameters

Parameter	Type	Default	Description
sort	string	pnl	Sort by: pnl, amount, volume
limit	integer	100	Max 300
offset	integer	0	Pagination offset

Example

curl https://api.polynode.dev/v3/markets/75783394880030392863380883800697645018418815910449662777195626260206142035810/positions?limit=1

{
  "data": [
    {
      "amount": "0",
      "avg_price": "490000",
      "realized_pnl": "9999999",
      "total_bought": "19607842",
      "user": "0xa435d9eb84bf50f5d72d88023a77e8c7fd1d572d"
    }
  ],
  "elapsed_ms": 204,
  "has_more": true,
  "limit": 1,
  "offset": 0,
  "rows_returned": 1
}

Response columns

Column	Type	Description
user	string	Wallet address
amount	string	Current shares held (6-decimal)
avg_price	string	Weighted-average entry price (6-decimal)
realized_pnl	string	Realized P&L (6-decimal USDC)
total_bought	string	Total volume bought (6-decimal USDC)