Skip to content

open source. open standard.

Underwriting.
In a common format.

Deal facts, assumptions and the reasoning behind them.
One readable record that people and software can share.

Markdown + JSON deterministic verification

cat parkview.uwx.md

Synthetic example · Engineering QA

The record

Markdown + JSON
---
uw_version: "3.0"
deal_name: "Parkview Apartments"
asset_class: "multifamily"
quick_metrics:
  purchase_price:   7200000
  noi_underwritten: 396635
  dscr:             1.109
  ltv:              0.70
---

## Underwritten NOI

Vacancy is normalized to 7%. Management fees
reflect the new agreement. Taxes are reassessed
to the post-sale value.

```json uw:section=noi_model
{
  "_meta": { … },
  "income": {
    "effective_gross_income": 630936
  },
  "expenses": {
    "total_operating_expenses": 234301
  },
  "net_operating_income": 396635
}
```

Abbreviated for display. Read the complete record

The presentation

Illustrative view

Parkview Apartments

48 units · Glendale, Arizona · 1987 vintage

Purchase price
$7,200,000
UW NOI
$396,635
DSCR
1.109×
Stated LTV
70.0%
Parkview operating statement: T-12 actuals and underwritten figures
Operating statementT-12UW
Gross potential rent$655,200$655,200
Vacancy / credit loss($32,760)($45,864)
Other income$18,000$21,600
Effective gross income$640,440$630,936
Operating expenses($228,344)($234,301)
Net operating income$412,096$396,635
Format
3.0
Protocol
4.1.0
Receipt
1.1
All versions
01 / READ

A file you can read.

Markdown carries the narrative. Typed JSON carries the structured data. Facts and assumptions stay together, with provenance.

02 / VERIFY

Results you can check.

People and AI write the record. Deterministic code checks covered financial results. A receipt records what was verified, not whether source documents are true.

How verification works →
03 / BUILD

An open foundation.

Implement the standard independently or use the reference toolkit. No required vendor, hosted service or account.

Explore the foundation →

Documentation

Start with the standard.
Build with the tools.

Implement the standard independently, or use the reference toolkit. The requirements and the tools have distinct roles.

Your first record

From terminal to deal file.

The published CLI runs with Node.js 18 or later. No account or repository clone is needed.

Follow the quickstart

quickstart.sh

npx @uwmd/cli init --output deal.uwx.md
npx @uwmd/cli validate deal.uwx.md
Or start from a template

Released under the MIT License.