Get top traders for a position

[ { "position_id": "<string>", "condition_id": "<string>", "market_slug": "<string>", "event_slug": "<string>", "category": "<string>", "title": "<string>", "question": "<string>", "image_url": "<string>", "trader": { "address": "<string>", "verified_badge": true, "name": "<string>", "pseudonym": "<string>", "profile_image": "<string>", "x_username": "<string>" }, "outcome": "<string>", "outcome_index": 123, "won": true, "total_buys": 123, "total_sells": 123, "converted_count": 123, "converted_shares_gained": 123, "converted_shares_lost": 123, "total_shares_bought": 123, "total_shares_sold": 123, "total_buy_usd": 123, "total_sell_usd": 123, "redemption_usd": 123, "merge_usd": 123, "convert_collateral_usd": 123, "avg_entry_price": 123, "avg_exit_price": 123, "avg_price": 123, "realized_pnl_usd": 123, "total_fees": 123, "first_trade_at": 123, "last_trade_at": 123, "current_price": 123, "last_traded_price": 123, "current_shares_balance": 123, "current_value": 123, "realized_pnl_pct": 123, "total_pnl_pct": 123, "end_date": 123, "is_neg_risk": true, "redeemable": true, "mergeable": true } ]

Query Parameters

position_id

string

required

Outcome-token ID

sort_by

enum<string>

Default: realized_pnl_usd Union of every sort_by value accepted by the positions endpoint across both status=open and status=closed. Note that some options are only meaningful for one status — for example current_value / current_price / redeemable / mergeable only apply to open positions, while redemption_usd only applies to closed ones. See PositionOpenPnlSortBy and PositionClosedPnlSortBy for the exact per-status whitelists.

Available options:

realized_pnl_usd,

total_buy_usd,

total_sell_usd,

redemption_usd,

total_buys,

total_sells,

total_shares_bought,

total_shares_sold,

avg_entry_price,

avg_exit_price,

avg_price,

total_fees,

first_trade_at,

last_trade_at,

current_value,

realized_pnl_pct,

total_pnl_pct,

current_price,

current_shares_balance,

merge_count,

split_count,

title,

end_date,

is_neg_risk,

redeemable,

mergeable

sort_direction

enum<string>

Default: desc

Available options:

asc,

desc

limit

integer<int32>

Default 50, max 200

offset

integer<int32>

Max 2500. Takes precedence over pagination_key.

pagination_key

string

Cursor from a previous response

Response

Top traders for the position

position_id

string | null

condition_id

string | null

market_slug

string | null

event_slug

string | null