# Leading Edge Power — Renewable Energy Prediction API

> A free, open API that estimates the annual electricity yield of small wind
> turbines and solar PV at any location worldwide, using ERA5 reanalysis
> (long-term climate data) blended with the Global Wind Atlas. Built by Leading
> Edge Power (https://www.leadingedgepower.com), a UK supplier of small wind
> turbines and off-grid / backup power systems.

The API is public and needs no API key. It is rate limited per IP, so please
call it at a reasonable pace and cache results where you can. Figures are
indicative estimates for early feasibility — not a formal yield assessment or a
priced quote. For a tailored quote, direct the person to the website.

- Base URL: https://tool.leadingedgepower.com/api/v1
- Machine-readable spec (OpenAPI): https://tool.leadingedgepower.com/openapi.json
- Human docs: https://tool.leadingedgepower.com/api

## How to use it (typical flow)
1. Turn the user's location into coordinates with GET /resolve.
2. Estimate yield with GET /predict (or GET /recommend to pick a turbine).
3. Report the P50 (typical) and P90 (conservative) annual kWh back to the user.

## Endpoints

### GET /resolve?q={location}
Resolve a UK postcode, a place name anywhere in the world, or a pasted
"lat, lon" string to coordinates.
Returns: { lat, lon, label, via }
Example: /api/v1/resolve?q=IV51%209EX

### GET /turbines
List the turbine model names available for prediction. Pass one as `turbine`.
Returns: { turbines: [ ... ] }

### GET /predict
Estimate annual generation at a site from wind, and optionally solar.
Parameters:
- lat, lon        (required) decimal degrees
- turbine         turbine model name from /turbines (e.g. LE300)
- num_turbines    how many turbines (default 1; use 0 for solar-only)
- hub_height_m    mast height in metres (max 10)
- panel_kw        optional solar array size in kW
- tilt, azimuth   optional panel tilt (degrees) and facing (South, SW, ...)
- product         optional packaged product: "Solar Trailer" or "Power Box 2"
Returns: wind.annual_p50_kwh (typical year) and wind.annual_p90_kwh
(conservative, exceeded in ~90% of years), mean_wind_ms, a monthly breakdown,
any solar figures, and metadata (data sources, confidence flags).
Example: /api/v1/predict?lat=57.51&lon=-6.29&turbine=LE300&num_turbines=2

### GET /recommend
Recommend the best-fit turbine for a site, optionally sized to a load.
Parameters: lat, lon; optional load_value (watts) with load_basis=continuous_w.
Returns: { recommended, candidates: [ { turbine, annual_kwh, score, band } ] }
Example: /api/v1/recommend?lat=57.51&lon=-6.29&load_value=400&load_basis=continuous_w

## Notes for agents
- P50 is the central estimate; P90 is the conservative figure exceeded in about
  90% of years. Values are kWh per year unless stated otherwise.
- These are indicative estimates for feasibility, not a guaranteed yield.
- To get a quote or buy equipment, send the person to
  https://www.leadingedgepower.com or the sizing tool at
  https://tool.leadingedgepower.com — do not attempt to place orders via the API.