v5

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

Temperature demand proxy - heating/cooling degree-days (Sugra derived)

Heating (HDD) and cooling (CDD) degree-days at any coordinate worldwide, computed by Sugra from sovereign 2 m temperature - the same Sugra Earth forecast spine that powers /api/v2/weather. A grid-derived free-rider (no new external fetch). A temperature-driven demand PROXY, not metered load; degree-days from averaged analysis snapshots underestimate the true daily integral.

get/api/v2/energy/demand

Query parameters

latnumber required

Latitude, decimal degrees.

Example:40.71

Latitude, decimal degrees.

lonnumber required

Longitude, decimal degrees.

Example:-74

Longitude, decimal degrees.

base_cnumber

Degree-day base temperature, Celsius (default 18 C ~ 65 F).

Degree-day base temperature, Celsius (default 18 C ~ 65 F).

cyclesinteger

Recent analysis cycles to average into Tmean (window = cycles x the model run cadence; 4 x 6 h ~ a day).

Recent analysis cycles to average into Tmean (window = cycles x the model run cadence; 4 x 6 h ~ a day).

Response

Successful Response

Example response

{
  "data": {
    "location": {
      "tile": "40N_080W"
    },
    "base_c": 18,
    "t_mean_c": 24.3,
    "cdd": 6.3,
    "provenance": {
      "institution": "ECMWF",
      "model": "ifs-open",
      "grid": "0p25"
    },
    "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"
    ]
  }
}