Accounts

Account portfolio

Returns a position-first portfolio view for an owner on a single chain. The backend builds SDK Account and Portfolio entities from internal V3 account, vault, price, and label data sources; it does not recursively call /v3/accounts/{address}/positions. When forceFresh=true, the endpoint enqueues or promotes account snapshot refresh work and waits briefly for refreshed snapshots before falling back to the current indexed portfolio view. Freshness metadata indicates whether the refresh completed, timed out, or was rate-limited. When any EVK position has unknown debt or controller state, affected SDK rows are omitted and the aggregate portfolio.totals properties are omitted instead of reporting an incomplete result as zero.

get/v3/accounts/{address}/portfolio

Path parameters

addressstring required

Query parameters

chainIdinteger required

Chain ID. Exactly one chain is required.

labeledVaultsOnlyboolean

Filter positions to the product-facing labeled vault universe.

includeAccountboolean

Include the backing SDK account-shaped payload for debugging and migration.

forceFreshboolean

When true, enqueue or promote account snapshot refresh for discovered tuples. The endpoint waits briefly for refreshed snapshots before falling back to the current indexed portfolio view. Inspect data.freshness for completion, timeout, rate-limit, and fallback metadata.

Response

Account portfolio

Changes

No recorded changes to this endpoint across all 1 revision of this API.