v1

OpenAPI 3.1.0Publishing notes2026-07-13171335.6 KB
ren_share

Traffic Signal

<b>Electricity traffic signal</b>

Returns the renewable share of load in percent from today until prediction is currently available and the corresponding traffic light.

The traffic light "signal" is indicated by the following numbers:

-1: Red (grid congestion),
0: Red (low renewable share),
1: Yellow (average renewable share),
2: Green (high renewable share)



If no data is available from the primary data providers, a best guess is made from historic data. This is indicated by "substitute" set to True.

"postal_code" is an optional input parameter, which will consider the local grid state (e.g. transmission line overload) in future implementations.

Response schema:

{
    "unix_seconds": [int],
    "share": [float],
    "signal": [int],
    "substitute": bool,
    "deprecated": bool
}
get/signal

Query parameters

countrystring
postal_codestring

Response

Successful Response

unix_secondsinteger[] required
sharenumber[] required
signalinteger[]
0: Red (low renewable share)
1: Yellow (average renewable share)
2: Green (high renewable share)
substituteboolean required
deprecatedboolean required