List aggregate daily cashflow snapshots

Get daily aggregate cashflow snapshots reported by an institution (e.g. self_report, visa) on behalf of an organization. Unlike /v3/ledger/transfers, each row is a period summary — typically one row per (institution, day, direction) — not an individual transaction. Use this endpoint when you want pre-aggregated totals; use /v3/ledger/transfers for line-item activity.

Results are sorted by occurredAt (descending — newest first). Ordering is not configurable from the query string.

Supports three response formats via the format query parameter:

• json (default) — paginated JSON (default limit 100, max 1000).
• csv — streamed CSV file download (up to 1,000,000 rows). Columns: inflow, transaction, type, timestamp, amount, usdValue, tokenAddress, tokenIcon, tokenSymbol.
• event-stream — Server-Sent Events stream (up to 1,000,000 rows). Each entry is emitted as a named entry event with JSON data. A final done event carries {"total": N}. Connect with EventSource or fetch:

const es = new EventSource('/v3/ledger/cumulative-cashflows?organizationId={id}&format=event-stream', {
  headers: { 'x-api-key': 'cc_...' },
});
es.addEventListener('entry', (e) => console.log(JSON.parse(e.data)));
es.addEventListener('done', (e) => { console.log('total:', JSON.parse(e.data).total); es.close(); });

Requires org membership or vault curator role (public orgs only).