v5

latestOpenAPI 3.1.0Proprietary2026-08-031,5423,1505.5 MB

Energy

Forecast PV generation potential (Sugra derived)

Forecast photovoltaic yield at any coordinate in the Caucasus region, computed by Sugra from the Sugra Earth forecast spine's shortwave radiation (GHI) and 2 m temperature via a clean-room irradiance-to-PV chain: NOAA/Spencer solar position, Erbs GHI->DNI/DHI decomposition, Hay-Davies plane-of-array transposition, Faiman cell temperature and a PVWatts derated DC + inverter-clipped AC model. Returns a 3-hourly per-kWp AC series to 48 h (with absolute kW/kWh when capacity_kwp is given) plus optional cross-check against observed SARAH-3 radiation. Regional (Caucasus) in v1 - worldwide forecast PV is pending dedicated compute. Modelled potential, not metered generation.

get/api/v2/energy/pv

Query parameters

latnumber required

Latitude, decimal degrees (Caucasus box in v1).

Example:41.7

Latitude, decimal degrees (Caucasus box in v1).

lonnumber required

Longitude, decimal degrees (Caucasus box in v1).

Example:44.8

Longitude, decimal degrees (Caucasus box in v1).

tiltnumber nullable

Panel tilt from horizontal, degrees. Default = latitude tilt.

azimuthnumber

Panel azimuth clockwise from north (180 = equator-facing/south).

capacity_kwpnumber nullable

Installed DC capacity, kWp. Absent -> per-kWp output only; present -> absolute kW/kWh too.

system_lossnumber

Aggregate PVWatts system loss fraction (soiling/mismatch/wiring/availability).

tech'c_si' | 'cdte' | 'cigs'

Module technology, sets the temperature coefficient (c_si -0.0040, cdte -0.0025, cigs -0.0036 /K).

temp_coeffnumber nullable

Explicit temperature coefficient of power (per K); overrides the tech default.

albedonumber

Ground albedo for the reflected plane-of-array term.

dc_ac_rationumber

DC:AC ratio; AC is clipped at nameplate/dc_ac_ratio.

inverter_effnumber

Constant inverter efficiency.

lead_hoursinteger

Forecast horizon in hours (3-hourly steps); capped at 48.

transposition'hay_davies' | 'isotropic'

Plane-of-array model: hay_davies (anisotropic) or isotropic (Liu-Jordan).

cross_checkboolean

Join observed SARAH-3 daily-mean GHI at the node as a directional sanity ratio (adds the SARAH-3 attribution).

Response

Successful Response

Example response

{
  "data": {
    "location": {
      "tile": "40N_080W"
    },
    "cycle": "2026071106",
    "series": [
      {
        "lead_hours": 24,
        "valid_time": "2026-07-12T06:00:00Z",
        "ghi_wm2": 420,
        "dni_wm2": 560,
        "dhi_wm2": 110,
        "poa_wm2": 610,
        "cell_temp_c": 38.5,
        "ac_w_per_kwp": 520
      }
    ],
    "totals": {
      "kwh_per_kwp": 6.2,
      "kwh": 62,
      "horizon_hours": 48
    },
    "config": {
      "tilt_deg": 41,
      "azimuth_deg": 180,
      "albedo": 0.2,
      "system_loss": 0.14,
      "temp_coeff": -0.004,
      "dc_ac_ratio": 1.15,
      "inverter_eff": 0.96,
      "decomposition": "erbs",
      "transposition": "hay_davies",
      "temp_model": "faiman"
    },
    "provenance": {
      "institution": "noaa",
      "model": "gfs",
      "grid": "0p25",
      "run": "2026-07-11T06:00:00Z",
      "cycle": "2026071106"
    },
    "attribution": {
      "attribution": [
        {
          "registry_key": "sugra/degree-days",
          "source_name": "Sugra (computed)",
          "licence": "CC-BY-4.0"
        }
      ],
      "effective_reexport": "allowed"
    }
  },
  "meta": {
    "endpoint": "/api/v1/fred/us/cpi",
    "data_time": "2026-04-16T14:30:00Z",
    "response_time": "2026-04-16T14:30:12Z",
    "provider": "Sugra API v1.0.1",
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ]
  }
}