Request contract

GET /api/v1/portfolios/{portfolioId}/transactions. List normalized deposits, withdrawals and cash flows for one portfolio resource. Send the personal token in X-API-Key and keep it outside browser code and public logs.

Response and metering

The paginated envelope includes transaction identity, type, asset, amount, optional USD value and occurrence time. Successful metered responses publish X-Credit-Cost and X-Credits-Remaining so usage can be recorded without another request.

Production behavior

Provider history can be incomplete. Use account and time filters, preserve pagination and do not present missing rows as proof that no flow occurred. Handle application/problem+json errors by stable code, preserve the correlation ID and never retry a mutation unless the workflow is idempotent.