Sign in

v2

latestOpenAPI 3.1.02026-07-316132736.5 KB
V2 - Wallet

Get Wallet Positions

Returns the complete token portfolio for a wallet: every token held with balance, USD value, price, 24h change, realized/unrealized PnL, cost basis, and full token metadata (name, symbol, logo, chain). Supports filtering by blockchain to reduce scope and cost. The primary endpoint for building wallet portfolio views, tracking holdings, or calculating net worth.

get/api/2/wallet/positions

Query parameters

walletstring required

Wallet address

Wallet address

chainIdsstring

Comma-separated list of chain IDs (e.g., "evm:1,evm:8453,solana:solana"). If omitted, all chains.

Comma-separated list of chain IDs (e.g., "evm:1,evm:8453,solana:solana"). If omitted, all chains.

limitnumber

Number of positions per page (1-500, default: 100)

Number of positions per page (1-500, default: 100)

offsetnumber nullable

Offset for pagination (default: 0)

Offset for pagination (default: 0)

cursorstring

Cursor for cursor-based pagination (takes precedence over offset)

Cursor for cursor-based pagination (takes precedence over offset)

cursorDirection'before' | 'after'

Cursor direction (default: after)

Cursor direction (default: after)

sortBy'lastActivity' | 'realizedPnl'

Sort field (default: lastActivity)

Sort field (default: lastActivity)

order'asc' | 'desc'

Sort order (default: desc)

Sort order (default: desc)

boolean required
OR
string required

Include fees in PnL calculation (deduct total_fees_paid_usd from PnL)

boolean required
OR
string required

Use swap recipient mode (query wallet_positions_recipients table instead of wallet_positions)

boolean required
OR
string required

Include all tokens the wallet holds, not just tokens with trading history

boolean required
OR
string required

Return only positions still held on-chain (filters out fully closed positions)

minPositionValueUSDnumber nullable

Drop positions worth less than this USD value (live RPC balance × live pool price)

Drop positions worth less than this USD value (live RPC balance × live pool price)

Response

Wallet positions response