Residual Load

Regional load forecast with LLM reasoning and real MaStR capacity anchors

LLM-based regional load forecast enriched with real MaStR installation data injected into the reasoning prompt.

What is real vs. LLM-estimated:

ComponentData source
Installed PV capacity (MW, installation count)MaStR (real)
Installed wind capacity (MW, installation count)MaStR (real)
SMARD population scaling factorSMARD.de (real)
Load profile shape, calendar effects, procurement recommendationLLM reasoning

Graceful degradation: If MaStR queries time out, the tool falls back to placeholder values and the LLM call still completes.

Use cases:

  • Stadtwerk procurement planning with natural-language recommendations
  • KPI summaries for management dashboards
  • When full hour-by-hour time-series (see netResidualLoad) is not needed
post/api/residual-load/load-forecast-regional

Request

  • Base URL: https://api.cernion.de
  • URL: https://api.cernion.de/api/residual-load/load-forecast-regional
  • Auth: none declared

Query parameters

tokenstring

Optional Cernion MCP token as URL query parameter. If provided, it overrides CERNION_TOKEN for this request. Prefer Authorization Bearer header in production to reduce token exposure in URLs/logs.

Request body

regionstring

City or region name

forecastDaysnumber

Number of days to forecast (1–7)

populationOverridenumber

Known population of the grid area. Improves load scaling accuracy.

gridOperatorMastrIdstring

MaStR Netzbetreiber-ID for EE capacity lookup

bundeslandstring

Federal state for MaStR capacity query

postleitzahlstring

5-digit postal code for MaStR capacity query

additionalContextstring

Extra context for the LLM (e.g. "large BASF industrial plant in area")

tokenstring

Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.

Example request

{
  "region": "Mannheim",
  "forecastDays": 1,
  "populationOverride": 320000,
  "gridOperatorMastrId": "SNB935578300972",
  "bundesland": "Baden-Württemberg",
  "postleitzahl": "68159",
  "additionalContext": "Large chemical plant (BASF) adds ~200 MW industrial base load"
}

Response

Load forecast generated successfully

successboolean
dataobject

LLM-generated load forecast analysis with real MaStR capacity anchors

Example response

{
  "success": true
}

Changes

No recorded changes to this operation across all 2 revisions of this API.