Skip to main content
Two read-only endpoints give everything a screen needs to draw a delivery day, or a whole month, in one call. They answer to a dashboard key, which n:lead issues separately. That key opens these two endpoints and nothing else, so it can sit on an office screen or in a BI tool. Days are covered from 120 days back to the forecast horizon (four days ahead). A month runs from its first covered day (from) to its last (to), so the current month ends at the horizon.

​
What the series are

Every series is a list of quarter-hour means in MW with six decimals (to the watt), aligned with interval_starts_utc. The schedule is on the TSOs’ 1 kW grid, as it was sent. A day has 96 quarter-hours, 92 on the spring clock change and 100 on the autumn one. null means the value is not there yet. It never means zero. forecast, schedule and allocation come for Germany (germany) and per control area (control_areas, with control_area set to TenneT, 50Hertz, Amprion or TransnetBW). Each block also has totals_mwh, the energy of each series. Germany’s allocation has a value only where every control area has its own. Signs. Consumption and production are both positive. A positive net_mw is net consumption. Allocation net_mw minus schedule net_mw is the imbalance: positive is short (more consumed than scheduled), negative is long.

​
Timing

  • Forecast and schedule are there from the day before delivery.
  • Allocation arrives the day after delivery as preliminary values. It is replaced by the settlement values when the month is settled.
  • reBAP is estimated until it is published, mostly in the course of the following month.
The data is read once and shared for 5 minutes, so polling more often returns the same object. The first call for a month reads every day and can take up to a minute; after that it is fast. Every five minutes for the current day and every 15 minutes for the month is plenty for a screen.

​
Charts and a wall screen

If nobody should have to build the graphics, the bridge draws them. The same data comes as SVG pictures, which stay sharp at any screen size: Options: area (germany by default, or TenneT, 50Hertz, Amprion, TransnetBW), theme (dark by default, or light) and lang (de by default, or en). A small portfolio is shown in kW, a larger one in MW. An <img> tag or a screen’s browser cannot send a header, so these three also take the key in the URL:
Open that in the screen’s browser in full-screen or kiosk mode. Only a dashboard key is accepted in a URL. Use a key of its own for each screen, so that one can be withdrawn without touching the others. The JSON endpoints still need the key in the X-API-Key header.

​
Errors