Skip to main content
GET
List a wallet's positions

Authorizations

X-API-Key
string
header
required

Preferred for swaps-api endpoints (/swaps/*, /stats/*, /trending, /pool-events).

Path Parameters

wallet
string
required

Wallet address (base58, 32–44 characters).

Query Parameters

status
enum<string>
default:open

Which positions to include.

Available options:
open,
closed,
all
mint
string

Filter to a single mint.

min_value_sol
number

Minimum read-time current_value_sol (applied post-pricing).

sort
enum<string>
default:value

Sort key.

Available options:
value,
realized,
unrealized
limit
integer
default:50

Page size.

Required range: 1 <= x <= 200
offset
integer
default:0

Page offset.

Required range: x >= 0
pnl_mode
enum<string>
default:adjusted

PnL accounting mode. strict (FIFO) and adjusted (weighted-avg cost) are realized-PnL figures; raw is net cash-flow (Σ sells − Σ buys), not realized PnL. Unknown values fall back to adjusted.

Available options:
raw,
strict,
adjusted
breakdown
enum<integer>
default:0

When 1, forces realized_breakdown onto every row.

Available options:
0,
1

Response

Positions page

wallet
string
pnl_mode
string
total
integer

True total under LIMIT (count() OVER ()).

limit
integer
offset
integer
positions
object[]