# SolarPulse

> Rooftop solar estimate, solar resource and electricity rates for any US location, from NASA POWER, EIA-861 and LBNL Tracking the Sun public data. Pay per query with x402 ($0.10); charged only for 2xx answers.

## Endpoints

- GET /v1/estimate?address=... — System size, production, utility rate, cost, payback, 25-year savings ($0.10)
- GET /v1/irradiance?lat=..&lon=.. — Monthly irradiance, optimal tilt, temperature, PV yield per kW ($0.10)
- GET /v1/rates?zip=... — Serving utilities, residential rate, typical bill, state trend ($0.10)
- GET /tryit — Static sample estimate (free)
- POST /v1/lead — Installer quote request {address, email, name?, phone?} (free)

## Data sources
- US Census Geocoder (TIGER/Line) and TIGERweb 2020 ZIP Code Tabulation Areas: address, point or ZIP -> location, county, state
- NASA POWER climatology 2001-2020 (CERES SYN1deg, MERRA-2; POWER data is also on the Registry of Open Data on AWS): monthly irradiance on tilted surfaces, air temperature
- Electric Retail Service Territories (HIFLD/ORNL): utilities serving the point, by EIA utility id
- EIA Form 861 2024 (final) via PUDL on the Registry of Open Data on AWS: residential price, usage and customers by utility; state averages and 2014-2024 trend
- LBNL Tracking the Sun (2024 edition) via OEDI on the Registry of Open Data on AWS: median installed price per watt by state (2023 installs)

## Limits
- Production is modeled (PVWatts-style losses on ~1-degree NASA POWER satellite climatology): typically within +/-10% for an unshaded, equator-facing roof. Shading, roof azimuth and local weather are not modeled.
- Rates are utility average revenue per kWh (fixed charges included), not your tariff. Savings assume every solar kWh offsets a purchased kWh (full net metering); under net billing (for example California NEM 3.0) exported kWh earn less.
- Federal: the Section 25D homeowner credit ended for expenditures after December 31, 2025, so owner-purchased systems installed in 2026 get no federal credit. State and utility incentives are not included.
- Installed prices are 2023 medians, the latest complete year in Tracking the Sun; 2026 quotes may differ. States with fewer than 100 sampled systems use the national median.
- Not tax, legal or financial advice.

## Payment
- x402 v2. Base: eip155:8453 USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 payTo 0x318A4B4764eb37c3FCBcE434713128143815FD57
- Solana: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp USDC EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v payTo GsKr5q9TmiJQcEgUpBp2X6SmvSg3dnXuw2uxYJxgPTk8
- API key: Authorization: Bearer sp_live_YOUR_KEY