列出市场最大持仓者
Top holders of a market, netted per user and grouped by outcome token.
?condition= (CSV of condition_id) is required (400 otherwise). ?limit=
(default 100, max 1000; v2 family-uniform) sizes the page per outcome
token; ?min_balance= filters the served amount.
?include_pnl=true opts each holder row into the position economics
(entry price and cost, current price and value, realized, unrealized and
total profit) and switches the amounts to per-side gross balances, so a
wallet holding both outcomes appears under both tokens. The default
response is unchanged. This mode serves one market’s table at a time:
exactly one condition and limit at most 100 (400 otherwise, including
via a cursor that carries a wider window).
A malformed condition id is a 400 naming the value; a well-formed one
that resolves to no holdings serves an empty data array, which is the
meaningful zero-state.
Deeper pages come only from ?cursor= (which carries the page window and
overrides limit).
Page walks advance every token group together, so a group leaves data
once its token is exhausted while others keep paging; no rows are lost,
but merge pages by token_id, not by array position.
授权
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
查询参数
Comma-separated condition_ids (at most 20 distinct values; exactly
one with include_pnl=true). Required. condition is the unified key
across v2 (same as the feeds and /v2/oi); condition_id /
conditionId are accepted aliases.
Rows per outcome token; defaults to 100, maximum 1000 (100 with
include_pnl=true).
0 <= x <= 1000Opaque pagination cursor from a prior response's next_cursor; carries
the per-token (limit, offset) window and overrides limit. Paging
past the first page is cursor-only.
Minimum net balance in shares (default 0), applied post-netting. With
include_pnl=true it applies to the served per-side gross amount
instead.
Opt into per-holder position economics (default false; includePnl
is an accepted alias). Adds avg_price, entry_cost_usdc,
current_price, current_value, realized_pnl, unrealized_pnl and
total_pnl to every holder row, and switches the served amounts to
per-side gross balances: a wallet holding both outcomes appears under
both tokens with per-side sizes and that side's economics, matching
/v2/positions for the same wallet and token. This mode serves one
market's table at a time: exactly one condition, limit at most 100.