Get trader position PnL

[ { "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_pnl_usd": 123, "unrealized_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 } ]

Path Parameters

address

string

required

Trader wallet address

Query Parameters

status

enum<string>

required

Required. open for positions still holding shares, closed for positions that have been fully exited or resolved.

Available options:

open,

closed

won

boolean

Only valid with status=closed. true to include profitable closed positions, false for closed positions with zero or negative realized PnL.

string

Case-insensitive substring match on the market title. Scoped to the chosen status — results never cross the open/closed boundary.

sort_by

enum<string>

Sort field. Default: total_pnl_usd. status=open accepts: realized_pnl_usd, total_pnl_usd, unrealized_pnl_usd, merge_usd, convert_collateral_usd, converted_count, converted_shares_gained, converted_shares_lost, last_traded_price, total_buy_usd, total_sell_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, title, current_price, current_shares_balance, merge_count, split_count, end_date, is_neg_risk, redeemable, mergeable. status=closed accepts: realized_pnl_usd, total_pnl_usd, unrealized_pnl_usd, 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, realized_pnl_pct, total_pnl_pct, title, merge_count, split_count, end_date, is_neg_risk. 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_pnl_usd,

unrealized_pnl_usd,

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 10, max 200

offset

integer<int32>

Max 3500. Takes precedence over pagination_key.

pagination_key

string

Cursor from a previous response

condition_id

string

Filter to a single market

market_slug

string

Filter by market slug

position_id

string

Filter to a single outcome token

min_shares

number<double>

Minimum shares balance to include

Response

Per-position PnL rows

position_id

string | null

Position ID.

condition_id

string | null

Condition ID.

market_slug

string | null

Market slug.

event_slug

string | null

Event slug.