v1

latestOpenAPI 3.0.32026-07-263871106.2 KB
Portfolio

Get user portfolio with all pools containing closed positions

Returns a paginated list of pools where the user has closed positions, sorted by most recent activity (last_closed_at DESC). The response includes:

  • Pool metadata (address, token symbols, icons, fees)
  • Aggregated PnL data (deposits, withdrawals, fees, total PnL)
  • Per-token breakdowns (X and Y)

For detailed position history within each pool, call the /positions/{pool_address}/pnl endpoint.

Arguments

  • user - The wallet address of the user
  • page - Page number for pagination (default: 1)
  • page_size - Number of pools per page (default: 120, max: 365)
  • days_back - Only include pools with positions closed within this many days (default: 90)

Returns

  • 200 - The user's portfolio with pool metadata and aggregated PnL
  • 400 - Invalid user address or query parameters
get/portfolio

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)

days_backinteger

Only include pools with positions closed within this many days Applied only for closed positions (minimum: 1, maximum: 365, default: 120)

Response

hasNextboolean required
pageinteger required
pageSizeinteger required
totalCountinteger required
totalPositionsinteger required

Total number of closed positions across all pools