NERVA API · Decision Engine · Starpoint Enterprises

What It Does

One Signal. Five States.

NERVA models every decision surface as a quantum state on the Bloch sphere. Von Neumann entropy governs the output. Low entropy = coherent signal. High entropy = noise dominates. The result is one of five states.

COMMIT

ψ < 0.25

Decision surface coherent. Signal clear and actionable. Act with confidence.

HOLD

ψ 0.25 – 0.42

Fundamentals positive but timing uncertain. Position for entry, await catalyst.

WAIT

ψ 0.42 – 0.60

Genuine two-way risk. Insufficient signal clarity for commitment at this horizon.

ESCALATE

ψ 0.60 – 0.78

Decision pressure building. Coherence degrading. Reduce exposure or prepare exit.

TOXIC

ψ > 0.78

Maximum entropy. No actionable signal. Stand aside — noise has overwhelmed the field.

API Reference

Endpoints

All endpoints are public. No API key required for basic use. Rate limited to 100 requests/hour per IP.

GET

/api/nerva

API documentation and available modes. Returns JSON schema and example payloads.

POST

/api/nerva

Decision engine. Send any structured inputs, receive COMMIT/HOLD/WAIT/ESCALATE/TOXIC with full entropy analysis.

GET

/api/fred?series=mortgage30

FRED economic data proxy. Returns mortgage rates, Fed funds rate, and financial indicators with NERVA signal.

GET

/api/noaa?severity=all

NOAA weather alerts mapped to NERVA nodes. Returns active alerts with entropy deltas per affected node.

GET

/api/energy?series=all

EIA energy price feed. WTI, Brent crude, Henry Hub natural gas, US gasoline — live prices with NERVA entropy.

GET

/api/census?zip=10001

Census ACS ZIP-level intelligence. Median home value, income, rent, affordability index, EV gate, vacancy rate.

GET

/api/corporate?metro=NYC&type=office

Corporate RE signals. Office, multifamily, industrial, retail — vacancy, cap rate, DSCR, NERVA state per metro.

GET

/api/realty?zip=07076

Live property listings by ZIP. Median price, days on market, price cuts, market velocity, NERVA entropy.

Input Modes

POST /api/nerva

Four modes map domain-specific inputs to the NERVA entropy framework.

Residential

Home purchase decision. Computes entropy from price-to-income ratio, days on market, mortgage rates, flood and fire risk, and rent yield EV gate.

homeValue medianIncome medianRent daysOnMarket mortgageRate floodRisk fireRisk

Corporate

Commercial real estate underwriting. Cap rate compression, vacancy cascade, lease rollover risk, DSCR, anchor tenant probability, climate exposure.

capRate vacancy leaseTermAvg debtServiceRatio anchorTenantRisk climateExposure

Geopolitical

Country and conflict risk modeling. Conflict intensity, institutional stability, economic stress, external shock probability, and time-to-resolution.

conflictIntensity institutionalStability economicStress externalShockProb timeToResolution

Custom

Direct access to the NERVA engine. Provide entropy and coherence values directly, or pass the off-diagonal density matrix element ρ₀₁ for full quantum treatment.

entropy coherence ev rho01

Interactive

Live API Demo

Send a real request to the NERVA decision engine and see the output.

Request Payload

{
  "mode": "residential",
  "inputs": {
    "homeValue":    664000,
    "medianIncome": 180000,
    "medianRent":   1790,
    "daysOnMarket": 22,
    "mortgageRate": 6.11
  },
  "horizon": 1
}

Response

            Press RUN NERVA to execute a live API call →
          

Code Examples

JavaScript / Fetch

const response = await fetch('https://nerva-globe.vercel.app/api/nerva', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    mode: 'residential',
    inputs: {
      homeValue:    664000,
      medianIncome: 180000,
      medianRent:   1790,
      daysOnMarket: 22,
      mortgageRate: 6.11,
    },
    horizon: 1, // 72 hours
  }),
});

const { state, signal, entropy, evGate, why } = await response.json();
console.log(state);   // "COMMIT"
console.log(signal);  // 78.4
console.log(entropy); // 0.2164

Python

import requests

response = requests.post(
    'https://nerva-globe.vercel.app/api/nerva',
    json={
        'mode': 'corporate',
        'inputs': {
            'capRate':          0.052,
            'vacancy':          0.18,
            'leaseTermAvg':     4.2,
            'debtServiceRatio': 1.15,
            'climateExposure':  0.3,
        },
        'horizon': 3,  # 6 months
    }
)

data = response.json()
print(data['state'])    # WAIT
print(data['entropy'])  # 0.5821
print(data['evGate'])   # False

The Framework

Quantum-Inspired Decision Math

NERVA is grounded in the mathematics of quantum information theory, applied to the structure of real-world decisions.

S(ρ) = -(p log₂p + q log₂q) Von Neumann entropy of the density matrix ρ. Where p and q are eigenvalues derived from the coherence-entropy pair of each node. Maximum entropy (S = 1.0) means the decision surface is fully incoherent — no useful signal. Minimum entropy (S = 0) means perfect coherence — act with full confidence.

ρ = [[p, ρ₀₁], [ρ₀₁*, q]] The 2\times2 density matrix. The off-diagonal element ρ₀₁ represents quantum coherence — the degree to which a signal carries actionable information across time. In NERVA, ρ₀₁ is seeded by domain-specific inputs: price appreciation trajectory in residential mode, lease term in corporate mode, institutional stability in geopolitical mode.

ε(h) = ε₀ \times δₕ Entropy decays across time horizons. Short-term volatility does not survive to 10-year analysis. The decay factors are [1.0, 0.92, 0.80, 0.65, 0.50, 0.35] for horizons 24h through 10yr. A market crisis that is ESCALATE at 24h may be HOLD at 2yr — the structural entropy is lower once volatility has been removed.

Horizon	Label	Decay Factor	What Survives
0	24h — Flash Crisis	1.00	Event volatility, news flow, sentiment spikes
1	72h — Tactical Window	0.92	Short-term momentum, liquidity conditions
2	30d — Operational	0.80	Supply/demand imbalances, rate trajectory
3	6mo — Strategic Arc	0.65	Structural fundamentals, policy shifts
4	2yr — Investment Cycle	0.50	Demographic trends, capital flows
5	10yr — Civilizational	0.35	Geography, demographics, climate physics

Live Intelligence

Data Sources

Seven live data feeds. All free, no credit card, no signup required for public endpoints.

USGS Earthquake Feed

Real-time seismic events M2.5+ worldwide. Each quake mapped to nearest NERVA node by geographic proximity. Magnitude → entropy delta.

FREE REAL-TIME

NOAA Weather API

Active weather alerts mapped to NERVA nodes by state. 922 alerts tonight — tornado warnings elevating Nashville Metro to ψ 0.95.

FREE 5 MIN

FEMA NFIP

Federal flood insurance claims and policy data. Carrier exit signals and flood loss history modulate insurance layer entropy.

FREE DAILY

FRED (St. Louis Fed)

30-year mortgage rates, Federal funds rate, and economic indicators. Live rate feeds modulate RE affordability entropy across all residential nodes.

FREE WEEKLY

EIA Open Data

WTI crude, Brent crude, Henry Hub natural gas, US regular gasoline. Price vs baseline → entropy on resources, energy, and geopolitics layers.

FREE DAILY

Census ACS + Realty

ZIP-level median home value, income, rent, vacancy from Census 2022. Live listings and days-on-market from Realty in US API.

FREE ANNUAL+LIVE