# 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 sample; cross-issuer daily-flow rollup for the last 7 days at most (N up to 7). Two views: settlement_events_daily (mint+burn count per UTC day, stacked by logical_label) and usd_pegged_net_flow_daily (net dollar inflow per UTC day for dollar-pegged asset classes), plus per_issuer_series and tracked_issuers without wallets.
- GET  https://vault.xrpl-utilities.io/stats/daily-flow-history?days=N — paid x402 $0.01 (free on xrpl-utilities.com); the same rollup for up to 90 days (default 30), with each tracked issuer's wallets and the auto-discovered candidates (tier provisional or noise, plus the signals behind it).
- 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. Three rails: XRP and RLUSD on XRPL through the t54 facilitator, or USDC on Base mainnet through the Coinbase x402 facilitator. The 402 envelope advertises all three.

## 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.