Documentation

Understand how Celvanto calculates appliance lifecycle costs, or integrate our analysis engine into your own application via the REST API.

Quickstart

Enter your ZIP, appliance type, and equipment details to get lifecycle cost rankings in under 5 minutes.

Lifecycle Cost Model

How we calculate the NPV of purchase, installation, energy, and maintenance costs over equipment lifetime.

Monte Carlo Simulation

10,000 energy price paths using EIA historical volatility and mean reversion parameters.

Maintenance Modeling

Weibull failure distributions calibrated from DOE equipment lifetime studies.

Incentive Stacking

How we combine IRA federal credits, state rebates, and utility programs per IRS stacking rules.

Carbon Savings

EPA eGRID emission factors for CO2 reduction estimates from efficient equipment.

API Endpoints

POST/v1/calculateRun TCO calculation for an appliance comparison

GET/v1/products/:categoryGet Energy Star products by category

GET/v1/rates/:zipGet utility rates by ZIP code

GET/v1/incentives/:zipGet available incentives by ZIP code

POST/v1/signupCreate account and get API key

POST/v1/checkoutCreate Stripe checkout session

Authentication

All API requests require an API key via the X-API-Key header.

curl https://api.celvanto.smarttechinvest.com/v1/rates/90210 \
  -H "X-API-Key: cel_your_api_key_here"

Lifecycle Cost Model

For each product, we compute total lifecycle cost as:

LCC = Purchase + Installation + Sum(Annual_Energy_Cost * Escalation^year + Maintenance + P(failure) * Repair_Cost) / (1 + discount_rate)^year - Incentives

Annual energy cost is computed from the appliance's efficiency rating (SEER, UEF, IMEF) and local utility rates from EIA. Maintenance uses Weibull failure distributions from DOE equipment lifetime studies.

Monte Carlo Energy Price Simulation

Rather than a single energy price assumption, Celvanto runs 10,000 simulated energy price paths using historical EIA state-level volatility and mean reversion. This produces a complete TCO distribution:

Expected (mean) TCO -- average across all scenarios
Median TCO -- 50th percentile, less sensitive to outliers
95th percentile TCO -- worst-case planning number
Breakeven probability -- chance that premium equipment pays for itself