Veloqua

Documentation

Understand how Veloqua optimizes homeowner insurance costs, or integrate our optimization engine into your own application via the REST API.

Quickstart

Enter your property details and get a multi-peril premium analysis in under 5 minutes.

Read more

Multi-Peril Decomposition

How we break your premium into component costs by peril: wind, fire, water, theft, liability, and more.

Read more

Monte Carlo Simulation

10,000 claim scenarios using Poisson frequency and lognormal severity distributions by territory.

Read more

Mitigation ROI

How we calculate payback periods and NPV for each home improvement using IBHS discount schedules.

Read more

Coverage Gap Analysis

Compares your coverage limits against replacement cost estimates using construction cost indices by ZIP.

Read more

Climate Trend Projector

5-10 year premium trajectory based on NAIC rate filing trends and First Street climate risk scores.

Read more

API Endpoints

POST/v1/calculate
POST/v1/optimize
GET/v1/fair-premium/:zip
GET/v1/risk/:zip
POST/v1/signup
POST/v1/login
GET/v1/account
POST/v1/checkout

Authentication

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

curl https://veloqua-api.smarttechinvest.com/v1/fair-premium/90210 \
  -H "X-API-Key: vlq_your_api_key_here"

Multi-Peril Premium Decomposition

For each property, we decompose the total premium into component costs by peril:

Total Premium = Wind/Hail + Fire + Water + Theft + Liability + Medical Payments + Loss of Use

Each peril component is derived from territory-based rating factors published in state DOI rate manuals, adjusted by construction type, year built, protection class (ISO), and claims history.

This decomposition lets you see exactly what you are paying for -- and where the greatest savings opportunities exist.

Monte Carlo Deductible Optimization

Rather than a single recommendation, Veloqua runs 10,000 simulated claim scenarios for each deductible level from $500 to $10,000. Each scenario draws from calibrated distributions:

  • Claim frequency: Poisson distribution by peril, calibrated to territory loss ratios
  • Claim severity: Lognormal distribution fitted to historical claims data
  • Expected annual cost: Premium + E[out-of-pocket claims] for each deductible
  • Optimal deductible: The level that minimizes total expected cost given your risk tolerance

The simulation produces confidence intervals so you can see both expected and worst-case costs at each deductible level.

Mitigation ROI Analysis

Each home improvement is modeled against published IBHS FORTIFIED Home discount schedules. We compute annual premium reduction, estimated improvement cost, payback period, and net present value (NPV) over 10 years for each action.

Actions are ranked by ROI so you can prioritize the improvements that offer the greatest return through premium savings.

Coverage Gap Analysis

Using Marshall & Swift / CoreLogic construction cost indices by ZIP, we estimate replacement cost for your specific property. We then compare your current dwelling coverage, personal property coverage, and liability limits against these estimates.

Underinsurance can be catastrophic. Overinsurance wastes money on unnecessary premiums. We flag both so you carry exactly the coverage you need.

Climate Trend Projection

Premiums do not stay constant. Using historical NAIC rate filing approval data and First Street Foundation climate risk scores (fire, flood, wind), we project your premium trajectory over 5-10 years using linear regression with climate risk drift.

This helps you plan for future costs and evaluate whether proactive mitigation investments can flatten your premium growth curve.