Energy Market Data

Historical portfolio market value backtest (Day-Ahead)

Computes the historical spot market value for a portfolio of energy installations.

Combines generation timeseries (inline upload, MaStR-based historical reconstruction, or technology assumption) with Day-Ahead prices over a selectable period (default: last 365 complete days).

Data quality priority per asset:

  1. uploaded_timeseries — inline timeseries array in request
  2. mastr_historical_reconstruction — solar/wind with mastrNumber, weather-based historical model
  3. assumption — biomass (7 500 h/a), hydro (4 200 h/a), combustion (3 500 h/a): flat profile
  4. missing_profile — storage and unknown types: generation = 0, warning emitted

Negative price handling: marketValueEur reflects physical generation including negative intervals; curtailedMarketValueEur shows the value under ideal curtailment; negativePriceAvoidableLossEur is the difference.

Limits: max 50 assets per request, max 365 days, region Deutschland only in v1.

post/api/energy-market/portfolio-backtest

Request

  • Base URL: https://api.cernion.de
  • URL: https://api.cernion.de/api/energy-market/portfolio-backtest
  • 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

dateFromstring date

Start date (YYYY-MM-DD). Default: today − 365 days

dateTostring date

End date inclusive (YYYY-MM-DD). Default: yesterday

resolution'hourly' | 'daily'

Response resolution

marketstring

Market type

regionstring

Market region (only "Deutschland" supported in v1)

includeTimeseriesboolean

Include full hourly timeseries in response

tokenstring

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

Example request

{
  "dateFrom": "2025-07-01",
  "dateTo": "2026-06-30"
}

Response

Backtest result (from /api/jobs/{jobId}/result once status is completed)

Changes

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