Load forecasting (SLP-based with historical correction), generation forecasting (MCP with KRITIS fallback), residual load calculation, Day-Ahead scheduling, storage dispatch optimization, and forecast quality evaluation (RMSE/MAE/MAPE).
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/cernion-de:cernion-de-forecast-prognostik-api"curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Cernion Energy Tools Forecast (Prognostik) API
version: 0.99.22
description: 'MicroService Agent System for Energy Markets - REST API with AI integration.
CERNION_TOKEN: request at https://cernion.de/ or by email: dev@stromdao.com.
For the public instance at https://api.cernion.de/, create your token at https://cernion.de/cet-token/.'
servers:
- url: https://api.cernion.de
description: API Server
tags:
- name: Forecast (Prognostik)
description: Load forecasting (SLP-based with historical correction), generation forecasting (MCP with KRITIS fallback), residual load calculation, Day-Ahead scheduling, storage dispatch optimization, and forecast quality evaluation (RMSE/MAE/MAPE).
paths:
/api/forecast-engine/load:
post:
summary: Generate load forecast for a day
tags:
- Forecast (Prognostik)
operationId: forecast_engine_forecastLoad
parameters:
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
description: 'Generates a 96-point (15-min) load forecast based on SLP profiles with optional historical correction and temperature adjustment. KRITIS-compliant: no external dependencies.'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- date
properties:
meloId:
type: string
example: DE0012345678901234567890123456789
profileId:
type: string
default: H0
date:
type: string
example: '2026-04-20'
annualConsumptionKwh:
type: number
default: 3500
temperatureCelsius:
type: number
example: 12
token:
type: string
description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
examples:
default:
value:
profileId: H0
date: '2026-04-20'
annualConsumptionKwh: 3500
temperatureCelsius: 12
/api/forecast-engine/generation:
post:
summary: Generate generation forecast (solar/wind)
tags:
- Forecast (Prognostik)
operationId: forecast_engine_forecastGeneration
parameters:
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
description: Wraps mastr_generation_forecast MCP tool with KRITIS-safe fallback. If MCP unavailable, uses installed capacity × typical capacity factor as estimate.
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- date
properties:
gridOperatorMastrId:
type: string
example: SNB935578300972
postleitzahl:
type: string
example: '66989'
installationType:
type: string
enum:
- solar
- wind
- all
default: solar
date:
type: string
example: '2026-04-20'
forecastDays:
type: number
default: 1
token:
type: string
description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
examples:
default:
value:
postleitzahl: '66989'
installationType: solar
date: '2026-04-20'
forecastDays: 1
/api/forecast-engine/residual:
post:
summary: Calculate residual load (consumption minus generation)
tags:
- Forecast (Prognostik)
operationId: forecast_engine_forecastResidual
parameters:
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- date
properties:
loadForecast:
type: object
example: {}
generationForecast:
type: object
example: {}
meloId:
type: string
example: DE0012345678901234567890123456789
profileId:
type: string
example: H0
annualConsumptionKwh:
type: number
example: 3500
postleitzahl:
type: string
example: '66989'
date:
type: string
example: '2026-04-20'
token:
type: string
description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
examples:
default:
value:
profileId: H0
annualConsumptionKwh: 3500
postleitzahl: '66989'
date: '2026-04-20'
/api/forecast-engine/schedule/day-ahead:
post:
summary: Create Day-Ahead schedule with optional storage optimization
tags:
- Forecast (Prognostik)
operationId: forecast_engine_createSchedule
parameters:
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- date
properties:
bilanzkreisId:
type: string
example: bk_es_test
meloId:
type: string
example: DE0012345678901234567890123456789
profileId:
type: string
example: H0
annualConsumptionKwh:
type: number
example: 3500
postleitzahl:
type: string
example: '66989'
date:
type: string
example: '2026-04-20'
storageConfig:
type: object
example:
capacityKwh: 10
maxChargePowerKw: 5
maxDischargePowerKw: 5
efficiency: 0.92
currentSocPercent: 50
includeMarketPrices:
type: boolean
default: false
token:
type: string
description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
examples:
default:
value:
date: '2026-04-20'
profileId: H0
annualConsumptionKwh: 3500
postleitzahl: '66989'
/api/forecast-engine/schedule/:scheduleId:
get:
summary: Get stored day-ahead schedule
tags:
- Forecast (Prognostik)
operationId: forecast_engine_getSchedule
parameters:
- name: scheduleId
in: path
required: true
schema:
type: string
example: schedule_2026-04-20_ab12cd34
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
/api/forecast-engine/quality:
post:
summary: Evaluate forecast quality (RMSE/MAE/MAPE)
tags:
- Forecast (Prognostik)
operationId: forecast_engine_evaluateQuality
parameters:
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
description: Compares SLP-based forecast against actual EDM timeseries data. Returns quality metrics and rating.
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- meloId
- from
- to
properties:
meloId:
type: string
example: DE0012345678901234567890123456789
obis:
type: string
default: 1-0:1.8.0
from:
type: string
example: '2026-04-13T00:00:00Z'
to:
type: string
example: '2026-04-14T00:00:00Z'
profileId:
type: string
default: H0
annualConsumptionKwh:
type: number
default: 3500
token:
type: string
description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
examples:
default:
value:
meloId: DE0012345678901234567890123456789
from: '2026-04-13T00:00:00Z'
to: '2026-04-14T00:00:00Z'
profileId: H0
annualConsumptionKwh: 3500
/api/forecast-engine/storage-dispatch:
post:
summary: Optimize battery storage dispatch
tags:
- Forecast (Prognostik)
operationId: forecast_engine_storageDispatch
parameters:
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- date
- storageConfig
properties:
residualLoad:
type: array
items:
type: object
example: []
meloId:
type: string
example: DE0012345678901234567890123456789
profileId:
type: string
example: H0
annualConsumptionKwh:
type: number
example: 3500
postleitzahl:
type: string
example: '66989'
date:
type: string
example: '2026-04-20'
storageConfig:
type: object
example:
capacityKwh: 10
maxChargePowerKw: 5
maxDischargePowerKw: 5
efficiency: 0.92
currentSocPercent: 50
marketPrices:
type: array
items:
type: object
example: []
token:
type: string
description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
examples:
default:
value:
date: '2026-04-20'
profileId: H0
annualConsumptionKwh: 3500
postleitzahl: '66989'
storageConfig:
capacityKwh: 10
maxChargePowerKw: 5
maxDischargePowerKw: 5
efficiency: 0.92
currentSocPercent: 50
/api/forecast-engine/schedules:
get:
summary: List stored schedules
tags:
- Forecast (Prognostik)
operationId: forecast_engine_listSchedules
parameters:
- name: bilanzkreisId
in: query
required: false
schema:
type: string
example: bk_es_test
- name: date
in: query
required: false
schema:
type: string
example: '2026-04-20'
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
/api/forecast/load:
post:
summary: Generate load forecast for a day
tags:
- Forecast (Prognostik)
operationId: postApiForecastLoad
parameters:
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
description: 'Generates a 96-point (15-min) load forecast based on SLP profiles with optional historical correction and temperature adjustment. KRITIS-compliant: no external dependencies.'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- date
properties:
meloId:
type: string
example: DE0012345678901234567890123456789
profileId:
type: string
default: H0
date:
type: string
example: '2026-04-20'
annualConsumptionKwh:
type: number
default: 3500
temperatureCelsius:
type: number
example: 12
token:
type: string
description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
examples:
default:
value:
profileId: H0
date: '2026-04-20'
annualConsumptionKwh: 3500
temperatureCelsius: 12
x-operation-id-source: normalized
x-operation-id-original: forecast_engine_forecastLoad
/api/forecast/generation:
post:
summary: Generate generation forecast (solar/wind)
tags:
- Forecast (Prognostik)
operationId: postApiForecastGeneration
parameters:
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
description: Wraps mastr_generation_forecast MCP tool with KRITIS-safe fallback. If MCP unavailable, uses installed capacity × typical capacity factor as estimate.
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- date
properties:
gridOperatorMastrId:
type: string
example: SNB935578300972
postleitzahl:
type: string
example: '66989'
installationType:
type: string
enum:
- solar
- wind
- all
default: solar
date:
type: string
example: '2026-04-20'
forecastDays:
type: number
default: 1
token:
type: string
description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
examples:
default:
value:
postleitzahl: '66989'
installationType: solar
date: '2026-04-20'
forecastDays: 1
x-operation-id-source: normalized
x-operation-id-original: forecast_engine_forecastGeneration
/api/forecast/residual:
post:
summary: Calculate residual load (consumption minus generation)
tags:
- Forecast (Prognostik)
operationId: postApiForecastResidual
parameters:
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- date
properties:
loadForecast:
type: object
example: {}
generationForecast:
type: object
example: {}
meloId:
type: string
example: DE0012345678901234567890123456789
profileId:
type: string
example: H0
annualConsumptionKwh:
type: number
example: 3500
postleitzahl:
type: string
example: '66989'
date:
type: string
example: '2026-04-20'
token:
type: string
description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
examples:
default:
value:
profileId: H0
annualConsumptionKwh: 3500
postleitzahl: '66989'
date: '2026-04-20'
x-operation-id-source: normalized
x-operation-id-original: forecast_engine_forecastResidual
/api/forecast/schedule/day-ahead:
post:
summary: Create Day-Ahead schedule with optional storage optimization
tags:
- Forecast (Prognostik)
operationId: postApiForecastScheduleDayAhead
parameters:
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- date
properties:
bilanzkreisId:
type: string
example: bk_es_test
meloId:
type: string
example: DE0012345678901234567890123456789
profileId:
type: string
example: H0
annualConsumptionKwh:
type: number
example: 3500
postleitzahl:
type: string
example: '66989'
date:
type: string
example: '2026-04-20'
storageConfig:
type: object
example:
capacityKwh: 10
maxChargePowerKw: 5
maxDischargePowerKw: 5
efficiency: 0.92
currentSocPercent: 50
includeMarketPrices:
type: boolean
default: false
token:
type: string
description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
examples:
default:
value:
date: '2026-04-20'
profileId: H0
annualConsumptionKwh: 3500
postleitzahl: '66989'
x-operation-id-source: normalized
x-operation-id-original: forecast_engine_createSchedule
/api/forecast/schedules:
get:
summary: List stored schedules
tags:
- Forecast (Prognostik)
operationId: getApiForecastSchedules
parameters:
- name: bilanzkreisId
in: query
required: false
schema:
type: string
example: bk_es_test
- name: date
in: query
required: false
schema:
type: string
example: '2026-04-20'
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
x-operation-id-source: normalized
x-operation-id-original: forecast_engine_listSchedules
/api/forecast/storage-dispatch:
post:
summary: Optimize battery storage dispatch
tags:
- Forecast (Prognostik)
operationId: postApiForecastStorageDispatch
parameters:
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- date
- storageConfig
properties:
residualLoad:
type: array
items:
type: object
example: []
meloId:
type: string
example: DE0012345678901234567890123456789
profileId:
type: string
example: H0
annualConsumptionKwh:
type: number
example: 3500
postleitzahl:
type: string
example: '66989'
date:
type: string
example: '2026-04-20'
storageConfig:
type: object
example:
capacityKwh: 10
maxChargePowerKw: 5
maxDischargePowerKw: 5
efficiency: 0.92
currentSocPercent: 50
marketPrices:
type: array
items:
type: object
example: []
token:
type: string
description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
examples:
default:
value:
date: '2026-04-20'
profileId: H0
annualConsumptionKwh: 3500
postleitzahl: '66989'
storageConfig:
capacityKwh: 10
maxChargePowerKw: 5
maxDischargePowerKw: 5
efficiency: 0.92
currentSocPercent: 50
x-operation-id-source: normalized
x-operation-id-original: forecast_engine_storageDispatch
/api/forecast/schedule/:scheduleId:
get:
summary: Get stored day-ahead schedule
tags:
- Forecast (Prognostik)
operationId: getApiForecastSchedule:scheduleId
parameters:
- name: scheduleId
in: path
required: true
schema:
type: string
example: schedule_2026-04-20_ab12cd34
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
x-operation-id-source: normalized
x-operation-id-original: forecast_engine_getSchedule
/api/forecast/quality:
post:
summary: Evaluate forecast quality (RMSE/MAE/MAPE)
tags:
- Forecast (Prognostik)
operationId: postApiForecastQuality
parameters:
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
description: Compares SLP-based forecast against actual EDM timeseries data. Returns quality metrics and rating.
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- meloId
- from
- to
properties:
meloId:
type: string
example: DE0012345678901234567890123456789
obis:
type: string
default: 1-0:1.8.0
from:
type: string
example: '2026-04-13T00:00:00Z'
to:
type: string
example: '2026-04-14T00:00:00Z'
profileId:
type: string
default: H0
annualConsumptionKwh:
type: number
default: 3500
token:
type: string
description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
examples:
default:
value:
meloId: DE0012345678901234567890123456789
from: '2026-04-13T00:00:00Z'
to: '2026-04-14T00:00:00Z'
profileId: H0
annualConsumptionKwh: 3500
x-operation-id-source: normalized
x-operation-id-original: forecast_engine_evaluateQuality
components:
parameters:
TokenQuery:
name: token
in: query
required: false
schema:
type: string
description: 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.
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
BearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: 'Optional Cernion MCP token. If not provided, falls back to CERNION_TOKEN from environment. Request token at https://cernion.de/ or by email: dev@stromdao.com.'