v1

latestOpenAPI 3.0.32026-07-263871106.2 KB
Portfolio

Get user portfolio with all pools containing open positions

Returns a paginated list of pools where the user has open (active) positions. The response includes:

  • Pool metadata (address, bin step, base fee, token symbols, icons)
  • Current balances and unclaimed fees in USD and SOL
  • Pool metrics (TVL, 24h volume, fee/TVL ratio)
  • List of open position addresses for each pool
  • Aggregated total metrics across all pools (balances, unclaimed fees, PnL) in USD and SOL
  • SOL price used for conversion (omitted if unavailable)

Results can be sorted by various metrics and support pagination.

Arguments

  • user - The wallet address of the user
  • page - Page number for pagination (default: 1, minimum: 1)
  • page_size - Number of pools per page (default: 20, maximum: 50)
  • sort_by - Field to sort by: current_balances, unclaimed_fee, pool_tvl, pool_volume_24h, or fee_per_tvl_24h (default: current_balances)
  • sort_direction - Sort direction: asc or desc (default: desc)

Returns

  • 200 - The user's open portfolio with pool metadata, balances, and total metrics
  • 400 - Invalid user address or query parameters
get/portfolio/open

Query parameters

userstring required

User's wallet address

pageinteger

Page number for pagination (minimum: 1, default: 1)

page_sizeinteger

Page size for pagination (default: 20, maximum: 50)

sort_direction'asc' | 'desc'

Sort direction, default is DESC

sort_by'current_balances' | 'unclaimed_fee' | 'fee_per_tvl24h'

Sort by field, default is current_balances

Response

Successfully retrieved open portfolio

hasNextboolean required
pageinteger required
pageSizeinteger required
{"stackTrail":"components:schemas:GetOpenPortfolioResponse:properties:solPrice","oasType":"schema","type":"unknown"}
totalCountinteger required
totalPositionsinteger required

Total number of open positions across all pools