Request contract

GET /api/v1/portfolio. Aggregate all synchronized portfolios owned by the authenticated API account into one current response. Send the personal token in X-API-Key and keep it outside browser code and public logs.

Response and metering

The envelope contains total USD value, asset positions, source-aware holdings and market-implied 24-hour fields. Successful metered responses publish X-Credit-Cost and X-Credits-Remaining so usage can be recorded without another request.

Production behavior

The 24-hour fields are not transaction-aware lifetime P&L. Use the performance endpoint for tracked historical results. Handle application/problem+json errors by stable code, preserve the correlation ID and never retry a mutation unless the workflow is idempotent.