v2

latestOpenAPI 3.1.0Publishing notes2026-08-04372580.6 KB

ren_share v2

Electricity traffic signal (renewable share of load)

Renewable share of load in percent from today until the end of the available forecast, together with a traffic light signal per timestamp: -1 = red (grid congestion), 0 = red (low renewable share), 1 = yellow (average), 2 = green (high renewable share).

get/v2/signal

Query parameters

country'ch' | 'eu' | 'all' | 'at' | 'ba' | 'be' | 'bg' | 'cy' | 'cz' | 'de' | 'dk' | 'ee' | 'es' | 'fi' | 'fr' | 'ge' | 'gr' | 'hr' | 'hu' | 'ie' | 'it' | 'lt' | 'lu' | 'lv' | 'md' | 'me' | 'mk' | 'nl' | 'no' | 'pl' | 'pt' | 'ro' | 'rs' | 'se' | 'si' | 'sk' | 'ua' | 'uk' | 'xk'

ISO-like country code accepted by the Energy-Charts API.

Country code

postal_codestring

Reserved for future local-grid awareness

Response

Successful Response

schema_versionstring required

Version of this response schema.

endpointstring required

Name of the endpoint that produced this response.

countrystring nullable

Country code the data refers to (lowercase), if applicable.

bidding_zonestring nullable

Bidding zone the data refers to, if applicable.

timezonestring required

IANA timezone in which all timestamps of this response are expressed.

resolutionstring nullable

Temporal resolution as ISO 8601 duration (e.g. PT15M, PT1H, P1D, P1M, P1Y). null if the time axis is irregular.

interval_minutesinteger nullable

Temporal resolution in minutes. null if irregular or if the step is calendar based (months / years).

unitstring nullable

Default unit of all series. Individual series may override it via series[*].unit.

generated_atstring required

ISO 8601 time at which this response body was generated. Responses may be served from a short-lived cache; this field always reflects the true generation time.

available_fromstring nullable

Timestamp of the first record that contains at least one non-null value. null if the response is empty.

available_untilstring nullable

Timestamp of the last record that contains at least one non-null value (data availability at generation time). null if the response is empty.

attributesobject

Endpoint specific metadata (e.g. forecast_type).

licensestring nullable

License of the data in this response.

deprecatedboolean required

True if this endpoint is scheduled for discontinuation.

Example response

{
  "attributes": {},
  "available_from": "2026-07-20T00:00:00+02:00",
  "available_until": "2026-07-20T19:30:00+02:00",
  "country": "de",
  "data": [
    {
      "timestamp": "2026-07-20T12:00:00+02:00",
      "values": {
        "renewable_share_of_load": 61.4,
        "solar": 42135.7,
        "wind_onshore": 18421.3
      }
    },
    {
      "timestamp": "2026-07-20T12:15:00+02:00",
      "values": {
        "renewable_share_of_load": 62,
        "solar": 42891.2,
        "wind_onshore": 18154.8
      }
    }
  ],
  "deprecated": false,
  "endpoint": "public_power",
  "generated_at": "2026-07-20T19:45:00+02:00",
  "interval_minutes": 15,
  "license": "CC BY 4.0 (creativecommons.org/licenses/by/4.0), attribution: energy-charts.info",
  "resolution": "PT15M",
  "schema_version": "2.0",
  "series": [
    {
      "id": "solar",
      "name": "Solar"
    },
    {
      "id": "wind_onshore",
      "name": "Wind onshore"
    },
    {
      "id": "renewable_share_of_load",
      "name": "Renewable share of load",
      "unit": "%"
    }
  ],
  "timezone": "Europe/Berlin",
  "unit": "MW"
}