Version 1.37 is a short-term support (STS) SaaS release that introduces the Portfolio Data Export Service.
Ripple Custody version 1.37 introduces the Portfolio Data Export Service, which generates reconciliation-grade financial reports from Ripple Custody as downloadable CSV or JSON files.
The service provides two report types, each exposed as a REST endpoint that returns a single file per request:
- Position Reports — a point-in-time balance snapshot, where each row is one account-and-asset balance as of a timestamp you choose.
- Movement Reports — a transaction history for a date range, where each row is one transfer, including amounts, fees, on-chain details, and counterparties.
Every export carries a metadata header with the request author, filters, record count, and financial control totals, so downstream systems can prove a file is complete and untampered. Column order, names, and types are a fixed contract, and the service exports all financial values as decimal strings in the asset's native unit to preserve full precision.
The service enforces access per domain: you receive data only for domains where you hold a role with read access, and it checks access against the target domain only, with no inheritance from parent domains. The service delivers REST APIs only in this release.
The export service depends on other platform components. Before using the reports, confirm with your operations team or Customer Partner Engineer (CPE) that the following are in place:
| Dependency | Needed for | Purpose |
|---|---|---|
| Gas Station service | Both reports | Determines each account's type (gas station or vault). This is a hard dependency: if Gas Station is unavailable, both reports return 502. |
| Ledger accounting refactor, phase 1 | Position Reports only | Provides point-in-time balance history. If the accounting stack is disabled, Position Reports return 5xx or empty results. |
| OAuth/OIDC (Keycloak) | Both reports | Validates your user JWT and obtains the service token the export service uses internally. The OIDC client must support the client_credentials grant. |
| PostgreSQL export schema | Both reports | Stores transaction history, enrichment data, domain access checks, and export metadata. |
| API Management Export route | Both reports | Exposes the /v1/exports endpoints. |
For on-premise deployments, enabling the export service also requires the export and gas-station components installed, the accounting stack enabled with HMZ_ACCOUNTING_SERVER_ENABLED for Position Reports, and the API Management Export route configured. Contact your CPE for the enablement configuration for your release package.
For more information, see:
Ripple progressively deploys Version 1.37 across SaaS environments starting July 10, 2026.
Ripple takes great care in testing its applications and ensuring that there are no regressions or breaking changes. Should you experience unexpected behavior, reach out to the Support team by creating a ticket on our Support Portal or contact your Customer Partner Engineer (CPE).