GET /api/vaults/:vaultId/nav — Unit NAV for a Facility

Use this endpoint to get the current per-unit value of a lending vault’s share token, keyed by vault ID. This is the stable, small document that a share token’s own metadata points at. Both the naive NAV (what AssetsTotal / sharesOutstanding would report) and the correct NAV (net of declared loss) are returned together, so you can see exactly what the obvious computation would have told you and how far it diverges from recoverable value.

Parameters

string

required

64-character hex object ID of the Vault ledger entry. Case insensitive.

This route sends Cache-Control: public, max-age=4 and Access-Control-Allow-Origin: *. It is designed to be called by parties with no prior relationship to Orma — any holder of vault shares can use it directly.

Request

curl -s http://localhost:8787/api/vaults/5763707D11EA19D1B5FF04E4EBA4F9336057955CDE65B725D1FF3EF2A96CB0E5/nav

Response

{
  "serverTime": "2026-09-12T22:20:22Z",
  "ledgerIndex": 5263343,
  "schema": "orma.nav/1",
  "asOf": "2026-09-12T22:20:22Z",
  "instrument": {
    "kind": "vault-share",
    "vaultId": "5763707D11EA19D1B5FF04E4EBA4F9336057955CDE65B725D1FF3EF2A96CB0E5",
    "shareMptId": "000000014D667775372D5B78E07FFF294678C7F9CE82AFBC",
    "unitsOutstanding": "51000000",
    "asset": { "kind": "XRP", "currency": "XRP", "issuer": null, "mptIssuanceId": null },
    "vaultKind": "ClosedEnded",
    "phase": "Investment",
    "redemptionAt": "2026-09-13T15:11:47Z"
  },
  "unitValue": {
    "held": "0.803922",
    "reported": "1.000000",
    "divergenceBps": 1961,
    "basis": "assets net of recognised loss, divided by units outstanding"
  },
  "valuation": {
    "currency": "XRP",
    "scale": 6,
    "perUnitHeld": "0.803922",
    "perUnitReported": "1.000000"
  },
  "assessment": {
    "grade": "AA",
    "gradeNumeric": 89,
    "methodVersion": "1.0.0",
    "advisory": true
  },
  "provenance": {
    "network": "devnet",
    "source": "devnet",
    "assetsTotal": "51000000",
    "lossUnrealized": "10000000",
    "unitsOutstanding": "51000000",
    "recompute": "(assetsTotal - lossUnrealized) / unitsOutstanding",
    "buildVersion": "3.4.0-rc5"
  }
}

Response Fields

string

Document schema identifier. Currently "orma.nav/1". Fields may be added in future minor versions; nothing will be renamed, retyped, or removed.

string

ISO 8601 ledger close time for this valuation. Same as serverTime.

object

Identifies the instrument being valued.

Show instrument fields

string

Always "vault-share" for this route.

string

64-character hex vault object ID.

48-character hex MPT issuance ID of the share token.

string

Total share units in circulation, in drops.

string

"OpenEnded" or "ClosedEnded".

string

Current vault lifecycle phase.

string

Scheduled redemption date. null for open-ended vaults.

object

The two NAV readings and the gap between them.

Show unitValue fields

string

Correct per-unit value: (assetsTotal - lossUnrealized) / unitsOutstanding.

string

Naive per-unit value: assetsTotal / unitsOutstanding. What a tool reading only AssetsTotal would report.

number

Basis-point gap between reported and held, rounded half-up. Zero until a loss is declared.

string

Plain-English description of the computation method.

object

Same values as unitValue, presented with explicit currency and scale metadata for machine consumption.

object

Credit grade for this facility.

Show assessment fields

string

Letter grade from "AAA" to "D".

number

Integer mapping of the grade.

boolean

Always true. The valuation is a measurement; the grade is an opinion. A grade computation failure must never suppress the valuation.

object

The three ledger fields used to compute held, so you can recompute it without trusting Orma, plus network context fields.

Show provenance fields

string

Network identifier, currently always "devnet".

string

Data source: "devnet" for live reads, "fixtures" for the recorded ring.

string

Vault.AssetsTotal in drops.

string

Vault.LossUnrealized in drops. "0" when the ledger omits the field.

string

MPTokenIssuance.OutstandingAmount in drops.

string

The formula as a string: "(assetsTotal - lossUnrealized) / unitsOutstanding".

string | null

Reported rippled build version. Informational only — never asserted by consumers. null when not available.

Both readings are returned on purpose. Handing over only the honest number asks you to take Orma’s word for it. Handing over both — with the gap named in basis points and all three source fields in provenance — lets you verify the computation yourself from publicly readable ledger state.

Overview

Vaults

Share Tokens

Diagnostics

GET /api/vaults/:vaultId/nav — Unit NAV for a Facility

Parameters

Request

Response

Response Fields

​Parameters

​Request

​Response

​Response Fields

Parameters

Request

Response

Response Fields