Skip to main content
GET
Get top traders for a position

Query Parameters

position_id
string
required

Outcome-token ID

sort_by
enum<string>

Default: realized_pnl_usd Sort field for position PnL results. Includes fee-excluded (raw_*) PnL metrics — see PositionOpenPnlSortBy and PositionClosedPnlSortBy for the per-status whitelists.

Available options:
realized_pnl_usd,
total_pnl_usd,
unrealized_pnl_usd,
raw_total_pnl_usd,
raw_realized_pnl_usd,
raw_unrealized_pnl_usd,
raw_total_pnl_pct,
raw_realized_pnl_pct,
raw_unrealized_pnl_pct,
merge_usd,
convert_collateral_usd,
converted_count,
converted_shares_gained,
converted_shares_lost,
last_traded_price,
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>

Row skip; clamped to a max of 3500. Takes precedence over pagination_key.

pagination_key
string

Cursor from a previous response

Response

Top traders for the position

position_id
string | null

Position ID.

condition_id
string | null

Condition ID.

market_slug
string | null

Market slug.

event_slug
string | null

Event slug.

category
string | null

Category.

title
string | null

Title.

question
string | null

Question.

image_url
string | null

Image URL.

trader
null | object

Trader wallet or profile.

outcome
string | null

Outcome.

outcome_index
integer<int32> | null

Outcome index.

combo_type
string | null

Combo market type: binary, negrisk, or combinatorial (parlay). Omitted for standard positions.

won
boolean | null

Won.

total_buys
integer<int64> | null

Total buys.

total_sells
integer<int64> | null

Total sells.

converted_count
integer<int64> | null

Converted count.

converted_shares_gained
number<double> | null

Converted shares gained.

converted_shares_lost
number<double> | null

Converted shares lost.

total_shares_bought
number<double> | null

Total shares bought.

total_shares_sold
number<double> | null

Total shares sold.

total_buy_usd
number<double> | null

Total buy in USD.

total_sell_usd
number<double> | null

Total sell in USD.

redemption_usd
number<double> | null

Redemption in USD.

merge_usd
number<double> | null

USD value from merge activity.

convert_collateral_usd
number<double> | null

Convert collateral in USD.

avg_entry_price
number<double> | null

Average entry price.

avg_exit_price
number<double> | null

Average exit price.

avg_price
number<double> | null

Volume-weighted average trade price across buys and sells.

realized_pnl_usd
number<double>

Realized PnL in USD.

total_pnl_usd
number<double>

Total PnL in USD.

unrealized_pnl_usd
number<double>

Unrealized PnL in USD.

total_fees
number<double> | null

Total fees.

first_trade_at
integer<int64> | null

First trade at timestamp.

last_trade_at
integer<int64> | null

Last trade at timestamp.

current_price
number<double> | null

Current price.

last_traded_price
number<double> | null

Last traded price.

current_shares_balance
number<double> | null

Current shares balance.

current_value
number<double> | null

Current value.

realized_pnl_pct
number<double> | null

Realized PnL percent.

total_pnl_pct
number<double> | null

Total PnL percent.

end_date
integer<int64> | null

End date timestamp.

is_neg_risk
boolean | null

Whether neg risk is true.

redeemable
boolean | null

Redeemable.

mergeable
boolean | null

Mergeable.

Last modified on July 28, 2026