Historical Energy / Degree Day API

Historical degree-day and energy-focused weather endpoint for load and demand analysis.

Returns weather context for cooling and heating demand analysis. Useful for power and utility analytics.

Be sure to check out our blog to read about the methodology for calculating degree days.

The following per API request limitations apply (See: pricing):

• Trial plan: 1 day of data per API request.
• ^*Business / Enterprise plans: 5 days of data per API request.
• Other plan(s): No access.

^*For convenience, up to 1 year of data can be requested per API request. However, requests that exceed 5 days will count as multiple requests against the plan daily quota. Example: 364 days = 73 requests, 30 days = 6 requests, etc.

• Historical CDD and HDD signals.
• Includes irradiance, precipitation, cloud, and wind.
• Designed for load forecasting and energy analytics.

Request Parameters

Example Request

Geolocation options: lat/lon (recommended)

lat/lon (recommended)

HTTP Shell Ruby Node.js Python

Copy

https://api.weatherbit.io/v2.0/history/energy?start_date=2026-06-08&end_date=2026-06-13&key=API_KEY&lat=35.7796&lon=-78.6382

curl -s "https://api.weatherbit.io/v2.0/history/energy?start_date=2026-06-08&end_date=2026-06-13&key=API_KEY&lat=35.7796&lon=-78.6382"

require 'uri'
require 'net/http'
require 'json'

uri = URI("https://api.weatherbit.io/v2.0/history/energy?start_date=2026-06-08&end_date=2026-06-13&key=API_KEY&lat=35.7796&lon=-78.6382")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = (uri.scheme == "https")
request = Net::HTTP::Get.new(uri)
response = http.request(request)
json = JSON.parse(response.body)
puts JSON.pretty_generate(json)

const https = require("https");

https.get("https://api.weatherbit.io/v2.0/history/energy?start_date=2026-06-08&end_date=2026-06-13&key=API_KEY&lat=35.7796&lon=-78.6382", (res) => {
  let raw = "";
  res.on("data", (chunk) => { raw += chunk; });
  res.on("end", () => {
    const json = JSON.parse(raw);
    console.log(JSON.stringify(json, null, 2));
  });
}).on("error", (err) => {
  console.error(err.message);
});

{
  "city_id": 5308655,
  "city_name": "Phoenix",
  "count": 1,
  "country_code": "US",
  "data": [
    {
      "cdd": 12.2,
      "clouds": 1,
      "date": "2026-05-31",
      "dewpt": 0.9,
      "hdd": 0,
      "max_wind_dir": 340,
      "max_wind_spd": 8.8,
      "precip": 0,
      "revision_status": "interim",
      "revision_version": "0.0",
      "rh": 16,
      "snow": 0,
      "sun_hours": 8.6,
      "t_dhi": 1328.2,
      "t_dni": 10633,
      "t_ghi": 8572.6,
      "t_solar_rad": 8567,
      "temp": 30.5,
      "temp_wetbulb": 14.9,
      "timestamp_local": null,
      "timestamp_utc": null,
      "wind_dir": 180,
      "wind_spd": 1.9
    }
  ],
  "end_date": "2026-06-01",
  "lat": 33.4484,
  "lon": -112.074,
  "sources": [
    "722780-23183",
    "imerg",
    "era5",
    "sat",
    "radar",
    "snodas"
  ],
  "start_date": "2026-05-31",
  "state_code": "AZ",
  "station_id": "722780-23183",
  "threshold_units": "C",
  "threshold_value": 18.33,
  "timezone": "America/Phoenix"
}

HTTP Statuses

{
  "error": "Some relevant message"
}

{
  "error": "Some relevant message"
}

{
  "error": "Rate limit exceeded.",
  "status_code": 429,
  "status_message": "Rate limit exceeded. Try again later."
}

{
  "error": "Server Error"
}

Return Fields