# Orma

- [Introduction: What Orma Measures and Why It Matters](https://ormaprotocol.mintlify.app/introduction.md): Orma catches the metadata gap that makes the first vault impairment invisible to indexers, then scores, publishes, and enforces on the result.
- [XRPL Vault Mechanics: Phases, Levers, and Accounting](https://ormaprotocol.mintlify.app/concepts.md): Learn how XLS-65 closed-ended vaults work: the three phases, the LoanBroker relationship, cash-basis accounting, and the two manager levers Orma measures.
- [Quickstart: Get the Orma Reader Running in Five Minutes](https://ormaprotocol.mintlify.app/quickstart.md): Start the Orma reader against four live Devnet facilities, call your first API endpoint, and read a vault's credit score — all in under five minutes.
- [Orma Credit Scoring: Six Risk Dimensions Explained](https://ormaprotocol.mintlify.app/scoring.md): Orma's six-dimension ordinal scoring system: how each factor is measured, why no weights are applied, and how the composite grade is derived.
- [NAV Pointer: Self-Describing Vault Share Collateral](https://ormaprotocol.mintlify.app/nav-pointer.md): How Orma embeds a valuation URL template in a vault share's immutable MPTokenMetadata so any holder can price the collateral without knowing Orma exists.
- [Gate Vault Deposits with Orma's ORMA-IG Credentials](https://ormaprotocol.mintlify.app/gate.md): How Orma's XLS-70 credential (ORMA-IG) and an XLS-80 permissioned domain enforce credit standards at the ledger level — no middleware, no approval flow.
- [Four Worked Examples: Using Orma as an Investor or Lender](https://ormaprotocol.mintlify.app/use-cases.md): Worked examples: comparing two facilities, pricing pledged vault shares, attracting rated capital, and gating deposits with XLS-70 credentials.
- [Consuming Orma from Autonomous Agents and Coding Assistants](https://ormaprotocol.mintlify.app/ai-agents.md): An agent holding vault shares needs no API key, no prior relationship, and no documentation — the token itself names the valuation endpoint. Here's how.
- [XRPL Lending Protocol: Key Findings for Developers](https://ormaprotocol.mintlify.app/findings.md): Seven verified findings from building on XLS-65 and XLS-66 on Devnet — the traps that cost hours, each with a transaction hash and a fix.
- [Orma Method Reference: Formulas and Oracle Encoding](https://ormaprotocol.mintlify.app/mathematics.md): Complete reference for every number Orma computes: NAV formulas, cover liquidation, ordering fairness, ordinal notching, and oracle encoding.
- [Orma REST API: Endpoints, Contracts, and Error Codes](https://ormaprotocol.mintlify.app/api/overview.md): The eleven GET endpoints Orma exposes, the six response contracts that bind every route, and the error codes and HTTP statuses returned on failure.
- [GET /api/vaults — List All Tracked Lending Facilities](https://ormaprotocol.mintlify.app/api/vaults-list.md): Returns all tracked lending facilities sorted worst-first by credit grade. No parameters. Each item includes NAV, grade, loan counts, and oracle status.
- [GET /api/vaults/:vaultId — Complete Facility Detail](https://ormaprotocol.mintlify.app/api/vault-detail.md): Returns everything about one facility: vault fields, broker, score with notch trace, every loan, phase info, oracle state, and active alerts.
- [GET /api/vaults/:vaultId/nav — Unit NAV for a Facility](https://ormaprotocol.mintlify.app/api/vault-nav.md): Returns per-unit NAV for one facility: net-of-loss held value, naive reported value, divergence in basis points, and raw source fields for recomputation.
- [GET /api/vaults/:vaultId/gate — Deposit Gate Status](https://ormaprotocol.mintlify.app/api/vault-gate.md): Returns whether a facility is gated by an XLS-70 credential domain, which credential types are accepted, and whether Orma's issuer address is named.
- [GET /api/vaults/:vaultId/collateral — Pledge Value](https://ormaprotocol.mintlify.app/api/vault-collateral.md): Scans escrows for pledged vault shares and values them at both naive and correct NAV, with an optional lender haircut applied to the honest figure only.
- [GET /api/vaults/:vaultId/broker-history — Conduct Record](https://ormaprotocol.mintlify.app/api/vault-broker-history.md): Reconstructs the broker's public transaction history, scores the default ordering against the fair sequence, and returns a reputation grade with findings.
- [GET /api/mpt/:mptId/nav — Unit Valuation by Share Token](https://ormaprotocol.mintlify.app/api/mpt-nav.md): Returns the per-unit NAV keyed by MPT issuance ID — the route a share token's own metadata points at. Optionally values a specific pledge of N units.
- [GET /api/mpt/:mptId/resolve — Pointer Resolution Audit](https://ormaprotocol.mintlify.app/api/mpt-resolve.md): Walks the pointer chain from an MPT issuance ID to a unit valuation, reporting every step including failures, to audit whether collateral is transparent.
- [GET /api/health — Reader Connectivity and Data Freshness](https://ormaprotocol.mintlify.app/api/health.md): Returns the reader's connection status, current ledger index, data source, build version, and degraded state with age when upstream is unhealthy.
- [GET /api/indexer-race — First-Impairment Invisible Proof](https://ormaprotocol.mintlify.app/api/indexer-race.md): Returns captured proof that a vault's first impairment is invisible to metadata diffing, including the raw transaction nodes and both NAV readings.