V2 Integrator API
Get Portfolio
Returns the authenticated tenant’s portfolio detail by ID.
GET
Returns a single portfolio owned by the authenticated tenant — identity,
portfolio display name, strategy metadata, per-chain smart accounts, and
rebalance schedule state.
For real-time balances and USD values call
Common error responses:
GET /v2/portfolios/{portfolioId}/positions.
The schedule block is the canonical source for rebalance visibility:
- Auth:
x-api-keyheader (required) - Scope:
portfolios:read
eip155:0:<address>;
smart accounts use the chain-bound form eip155:<chainId>:<address>. Owners
are EVM EOAs today.
Returns 404 for portfolios your API key does not have access to —
same response shape as a portfolio that doesn’t exist.
Portfolio identifier returned by
POST /v2/enroll or GET /v2/portfolios.400when the path parameter is invalid401whenx-api-keyheader is missing or the key is invalid403when the API key lacks theportfolios:readscope404when the portfolio does not exist or does not belong to the tenant500on unexpected server errors