Request
Query parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
status | string | — | Filter: open, closed, redeemable, redeemed |
sort | string | recent | Sort by: pnl, size, volume. Default is most recent first. |
order | string | desc | asc or desc |
token_id | string | — | Filter by outcome token ID |
condition_id | string | — | Filter by market condition ID |
market_slug | string | — | Filter by market slug |
min_size | number | — | Minimum position size in USD |
limit | integer | 100 | Max 300 |
offset | integer | 0 | Pagination offset |
Position statuses
Global positions use the same lifecycle statuses as wallet positions:| Status | Meaning |
|---|---|
open | Wallet holds shares in an active (unresolved) market |
closed | Position fully sold before market resolved |
redeemable | Market resolved, wallet still holds shares that can be redeemed |
redeemed | Market resolved and shares have been redeemed |
Examples
Latest position changes
Biggest open positions
Who holds positions in a specific market
Unclaimed redeemable positions
Response fields (per row in positions)
This endpoint returns a leaner field set than /v3/wallets/{addr}/positions. For full enrichment (last_trade_at, tag_slugs, event_slug, market_status, opposite_asset, price_source, redeemable_payout, won, etc.), use the per-wallet endpoint.
| Field | Type | Nullable | Description |
|---|---|---|---|
wallet | string | no | Wallet address |
token_id | string | no | Outcome token ID (decimal-string-encoded — see Identifiers) |
size | number | no | Current shares held (USD) |
avg_price | number | no | Weighted-average entry price (USD per outcome token) |
realized_pnl | number | no | Realized P&L (USD) |
unrealized_pnl | number | no | Unrealized P&L (USD) — (current_price - avg_price) * size |
total_pnl | number | no | realized_pnl + unrealized_pnl (USD) |
current_price | number | no | Latest token price (USD). Falls back to 0 if no price is known yet. |
total_bought | number | no | Total USD spent buying this position |
resolved | boolean | no | Whether the market has settled |
status | string | no | open, closed, redeemable, or redeemed |
market | string | yes | Market question (null if the token’s metadata hasn’t been backfilled) |
slug | string | yes | Market URL slug |
outcome | string | yes | Outcome label |
outcome_index | integer | yes | Outcome position (0 or 1) |
image | string | yes | Market image URL |
condition_id | string | yes | Market condition ID |
neg_risk | boolean | yes | Neg-risk (multi-outcome) market flag |