# XR-Vault
Real-world asset tracker for the XRP Ledger.

- POST https://vault.xrpl-utilities.io/scan — paid x402 (~$0.10 USD per call); accepts {issuer: <wallet OR logical_label OR currency>}; returns per-issuer current circulating + 24h flow + AMM exposure + 24h XLS-85 token-escrow block (count, amount_sum, dvp_candidate_count, pct_of_net_circulating) + 24h issuer-deepfreeze block (tx_count, unique_holders_count) + accruing daily history. When the scanned issuer wallet also operates an XLS-80 permissioned domain, the response carries an optional trust_fingerprint block (per-wallet domain_count, credentials_issued/outstanding, unique_subjects_count, first_seen/last_active timestamps, 24h permissioned-offer/AMM activity, DID identity presence). Descriptive on-chain fact, not a compliance verdict.
- GET  https://vault.xrpl-utilities.io/stats/daily-flow?days=N — free; cross-issuer daily-flow rollup (N up to 90, default 30). Two views over Vault's accruing daily snapshots: settlement_events_daily (mint+burn count per UTC day, stacked by logical_label, currency-agnostic) and usd_pegged_net_flow_daily (net dollar inflow per UTC day, restricted to asset classes where the native unit is at or near 1 USD). Also returns per_issuer_series (per-day mints/burns/net in native units for every tracked issuer) and tracked_issuers (live registry snapshot driving the charts).
- GET  https://vault.xrpl-utilities.io/agents.json — manifest, full tracked-issuer list, payment terms.
- GET  https://vault.xrpl-utilities.io/healthz — liveness probe.
- GET  https://vault.xrpl-utilities.io/stats — operational metrics.
- GET  https://vault.xrpl-utilities.io/docs — Swagger UI.
- GET  https://vault.xrpl-utilities.io/openapi.json — OpenAPI 3 spec.

## Pricing
$0.10 USD per /scan via x402 v2 (XRPL `exact` scheme, t54 facilitator). XRP and RLUSD both accepted; the 402 envelope offers both.

## What this service is not
Not a NAV oracle. Not a USD valuation engine. Not an editorial 'is this RWA legitimate' verdict. We report on-chain figures in native units; consumers who need fiat translation pair this data with their own price feed.