Skip to main content

Documentation Index

Fetch the complete documentation index at: https://polynode.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Returns the most recent position changes across all wallets, enriched with market metadata and current prices. Defaults to most recent positions first.

Request

GET /v3/positions

Query parameters

ParameterTypeDefaultDescription
statusstringFilter: open, closed, redeemable, redeemed
sortstringrecentSort by: pnl, size, volume. Default is most recent first.
orderstringdescasc or desc
token_idstringFilter by outcome token ID
condition_idstringFilter by market condition ID
market_slugstringFilter by market slug
min_sizenumberMinimum position size in USD
limitinteger100Max 1000
offsetinteger0Pagination offset

Examples

Latest position changes

curl https://api.polynode.dev/v3/positions?limit=5

Biggest open positions

curl https://api.polynode.dev/v3/positions?sort=size&status=open&limit=5

Who holds positions in a specific market

curl "https://api.polynode.dev/v3/positions?condition_id=0xdd22472e...&sort=pnl&limit=10"

Unclaimed redeemable positions

curl "https://api.polynode.dev/v3/positions?status=redeemable&min_size=100&sort=size&limit=10"

Response fields

FieldTypeDescription
walletstringWallet address
token_idstringOutcome token ID
sizenumberCurrent shares held (USD)
avg_pricenumberAverage entry price (USD)
realized_pnlnumberRealized P&L (USD)
unrealized_pnlnumberUnrealized P&L (USD)
total_pnlnumberrealized_pnl + unrealized_pnl (USD)
current_pricenumberCurrent token price (USD)
total_boughtnumberTotal volume bought (USD)
resolvedbooleanWhether the market has settled
statusstringopen, closed, redeemable, or redeemed
marketstringMarket question text
slugstringMarket URL slug
outcomestringOutcome label
outcome_indexintegerOutcome position (0 or 1)
imagestringMarket image URL
condition_idstringMarket condition ID
neg_riskbooleanWhether this is a neg-risk market