Skip to main content
GET
List combo positions with legs, metadata, and PnL

Path Parameters

address
string
required

Trader wallet address

Query Parameters

status
enum<string>

Lifecycle filter; omit for all combos. resolved matches wins and losses; resolved_win also matches redeemable/redeemed Status filter for the combo listing. Looser than the entry's status field: resolved matches wins and losses, and resolved_win also matches redeemable/redeemed combos.

Available options:
open,
closed,
resolved,
resolved_win,
resolved_loss,
redeemable,
redeemed

Case-insensitive substring match on the combo market title.

sort_by
enum<string>

Default: total_pnl_usd. Aggregated across the combo's held sides. title sorts alphabetically by market title; end_date sorts by the market resolution date; redeemable surfaces combos with redeemable winning shares. Sort keys for the combo listing — aggregates summed (or, for the timestamps, min/max) across a combo's held sides. title sorts by combo market title, end_date by market resolution date, and redeemable by whether a winning held side still has shares.

Available options:
total_pnl_usd,
realized_pnl_usd,
unrealized_pnl_usd,
raw_total_pnl_usd,
raw_realized_pnl_usd,
raw_unrealized_pnl_usd,
total_buy_usd,
first_trade_at,
last_trade_at,
title,
end_date,
redeemable
sort_direction
enum<string>

Default: desc

Available options:
asc,
desc
limit
integer<int32>

Page size (default 10, max 100)

offset
integer<int32>

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

pagination_key
string

Cursor from the previous page

Response

Combo entries with per-leg detail and position PnL

condition_id
string
required

Normalized combo condition id.

is_dead
boolean
required

True once the position can no longer pay out.

legs_won
integer
required
Required range: x >= 0
legs_lost
integer
required
Required range: x >= 0
legs_pending
integer
required
Required range: x >= 0
leg_count
integer
required
Required range: x >= 0
legs
object[]
required
position
object

The trader's position row for this combo (same shape as the positions endpoint). Omitted when the trader holds no position on this combo.

implied_probability
number<double> | null

Probability of this position paying out, implied by current leg prices (resolved legs count as 0 or 1).

potential_payout
number<double> | null

Gross USD payout if this held side can still win/redeem, or the already-realized redemption amount when it has won and redeemed. Omitted for dead losing positions and zero-balance closed positions.

status
null | enum<string>

Lifecycle state of the combo. Omitted when the trader holds no position on it.

Available options:
open,
closed,
resolved_win,
resolved_loss,
redeemable,
redeemed
Last modified on July 28, 2026