JouloDocs
Api referenceEnergy

Get the EPEX price forecast for the coming days

The Dutch EPEX day-ahead price for today and up to 6 more days, per hour, in euro per kWh excl. VAT, energy tax and supplier markup. Hours with a published price carry known_eur_per_kwh. The hours after that carry Joulo's forecast: forecast_p50 with the band forecast_p10 to forecast_p90, which held about 8 in 10 real prices in the backtest. The model starts from the mean of the same hour over the last 7 known days and adds how wind, sun and temperature in the Netherlands and Germany differ from that week, from the Open-Meteo forecast. It is retrained every day. forecast_available is false when no model or weather forecast is at hand; the known hours still come back. Any personal token may read it.

GET
/prices/forecast
AuthorizationBearer <token>

API token from the Joulo dashboard, or an OAuth2 access token.

In: header

Query Parameters

days?integer

Days including today.

Default3
Range1 <= value <= 7

Response Body

curl -X GET "https://api.joulo.nl/functions/v1/api/prices/forecast?days=3"
{
  "source": "EPEX day-ahead via ENTSO-E; forecast by Joulo from Open-Meteo weather",
  "unit": "EUR/kWh excl. VAT, energy tax and supplier markup",
  "timezone": "Europe/Amsterdam",
  "model_trained_at": "2026-10-29T11:20:41Z",
  "forecast_available": true,
  "per_day": [
    {
      "date": "2026-10-31",
      "is_forecast": true,
      "hours": 24,
      "average_eur_per_kwh": 0.1768,
      "cheapest_hour": "12:00",
      "cheapest_eur_per_kwh": 0.115,
      "priciest_hour": "19:00",
      "priciest_eur_per_kwh": 0.285
    }
  ],
  "columns": [
    "time_local",
    "time_utc",
    "known_eur_per_kwh",
    "forecast_p10",
    "forecast_p50",
    "forecast_p90"
  ],
  "rows": [
    [
      "2026-10-29 00:00",
      "2026-10-28T23:00:00.000Z",
      0.241,
      null,
      null,
      null
    ],
    [
      "2026-10-31 12:00",
      "2026-10-31T11:00:00.000Z",
      null,
      0.061,
      0.115,
      0.17
    ]
  ]
}
{
  "error": "invalid_days",
  "detail": "days must be a whole number from 1 to 7."
}
{
  "error": "Missing or invalid API token"
}