Solar savings calculations,
as an API

Accurate, per-address solar savings analysis for California. Real utility rate schedules, hourly load profiles, and 25-year financial projections — in a single API call.

Try it out →

How it works

Address in, savings out

Send an address and system configuration. Get back a complete financial picture.

1. Locate

Geocode the address. Identify the utility territory, rate schedule, and CEC climate zone.

2. Simulate

Build an 8,760-hour load profile and solar generation curve using NREL-calibrated models.

3. Calculate

Apply real TOU rates, NEM tariffs, and battery dispatch to produce before/after bills and 25-year NPV.

Built for Accuracy

Our Data Methodology

We don't rely on simple monthly averages or guesswork. Every quote is powered by a high-resolution, physics-based simulation engine.

8,760-Hour Precision

Instead of monthly estimates, we simulate all 8,760 hours of the year. We adjust baseline climate profiles against your actual consumption to model exactly when power is used.

Hyper-Local Climate Data

We map coordinates using proprietary mapping and a California Energy Commission (CEC)-backed recognition formula to pinpoint your exact utility territory and climate zone, accounting for 50-meter border overlaps.

Weather-Adjusted Profiling

We decompose energy usage into heating, cooling, and baseload components, dynamically adjusting them against localized weather data to accurately mirror seasonal shifts.

Directional Solar Modeling

We cross-reference system hardware, roof tilt, and azimuth with NREL production metrics to calculate exactly how much power your specific layout will generate.

Physical Battery Simulation

We model real-world state-of-charge, charge/discharge limits, and round-trip efficiency losses based on real hardware specs to accurately forecast battery savings.

Complex Tariffs & NEM 3.0

We run the hourly net usage against actual utility rate engines. We handle TOU arbitrage, non-bypassable charges, and true Avoided Cost Calculator (ACC) export credits.

API Reference

Endpoints

Three endpoints cover the full solar savings workflow. All require API key authentication.

POST

/v1/identify-rates

Geocode an address and identify the utility territory, applicable pre-solar and post-solar rate schedules, and CEC climate zone.

GET

/v1/utilities/:slug/rates

List all rate schedules for a given utility, including TOU periods, tiered pricing, and solar eligibility.

POST

/v1/quotes

Generate a complete solar savings quote: hourly simulation, monthly and annual summaries, before/after bills, and 25-year financial projections with battery support.

GET

/v1/quotes/:id

Retrieve a previously generated quote by ID, including full summary data and financial metrics.

Quick Start

One request, complete analysis

Here's what a full quote request and response looks like.

# Generate a solar savings quote
curl -X POST https://api.solarsavingsdata.com/v1/quotes \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -d '{
    "address": "1600 Amphitheatre Parkway, Mountain View, CA",
    "system_size_kw": 8.0,
    "annual_kwh": 10000
  }'

{
  "quoteId": "quote_a1b2c3d4e5f6g7h8",
  "engineVersion": "1.0.0",
  "status": "complete",
  "location": {
    "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043",
    "utilitySlug": "pge",
    "utilityName": "Pacific Gas & Electric",
    "cecClimateZone": 4
  },
  "system": {
    "systemSizeKw": 8.0,
    "panelCount": 20,
    "tilt": 20,
    "azimuth": 180
  },
  "annual": {
    "annualLoadKwh": 10000,
    "annualSolarKwh": 12480,
    "annualBeforeBill": 3200.50,
    "annualAfterBill": 845.20,
    "annualSavings": 2355.30,
    "solarOffsetPercentage": 124.8
  },
  "financials": {
    "grossSystemCost": 24000,
    "federalTaxCreditAmount": 7200,
    "netSystemCost": 16800,
    "annualSavings": 2355.30,
    "year1Savings": 2355.30
  }
}

Get Started

Request Access

Interested in integrating our API? Request access below.

Solar savings calculations,as an API