Sign in

v1

latestOpenAPI 3.1.02026-07-228799577.7 KB
Wallet

Get Wallet Positions

Returns paginated token positions for a wallet. Each list item exposes the same trade-activity fields as /v2/pnl/wallets/:wallet/tokens/:token (volume, counts, timing, and related PnL fields). Supports sorting plus filters for holding state, PnL, ROI, invested capital, market, liquidity, market cap, and token list.

get/v2/pnl/wallets/{wallet}/positions

Path parameters

walletstring required

Solana wallet address (base58, 32-44 characters).

Query parameters

pnlMode'strict' | 'adjusted' | 'raw'

How to treat positions flagged by the invalid PnL heuristic. strict zeros them out, adjusted caps them to a cost-basis-aware value, and raw leaves realized PnL untouched. Aliases pnl_mode and mode are also accepted by the API.

sort'last_trade' | 'pnl' | 'realized' | 'unrealized' | 'roi' | 'value' | 'holding' | 'invested' | 'cost' | 'proceeds' | 'buys' | 'sells'

Field to sort positions by.

direction'asc' | 'desc'

Sort direction.

cursorstring

Opaque pagination cursor returned from the previous page's pagination.nextCursor.

limitinteger

Results per page (1-200).

filter'all' | 'holding' | 'active' | 'sold' | 'profitable' | 'losing'

Filter positions by status.

period'1d' | '7d' | '14d' | '30d' | '90d' | 'all'

Only show positions with activity within this time period.

tokensstring

Comma-separated list of token mint addresses to filter by. Maximum 100 tokens.

minValuenumber

Minimum current USD value of the position.

maxValuenumber

Maximum current USD value.

minPnlnumber

Minimum total PnL (USD).

maxPnlnumber

Maximum total PnL.

minInvestednumber

Minimum total invested (USD).

maxInvestednumber

Maximum total invested.

minRoinumber

Minimum ROI percentage.

maxRoinumber

Maximum ROI percentage.

minTradesinteger

Minimum trade count.

minHoldingnumber

Minimum token balance (native units).

marketstring

Filter by primary market/DEX (e.g. Raydium, Orca).

minLiquiditynumber

Minimum token liquidity in USD.

minMarketCapnumber

Minimum token market cap in USD.

Response

Successful response.

walletstring