BASE/api/v1 ·

/prices/todayzone=DK1|DK2, postcode=2100 gridArea=791
/prices/tomorrow
/prices + date=YYYY-MM-DD
/cheapest-hourszone, n=3 , kwh=1, basis=auto|spot|spotVat|full
/methodology
/health

curl 'http://127.0.0.1:3210/api/v1/prices/today?zone=DK2&postcode=2100'
{
  "date": "2026-11-11", "zone": "DK2", "status": "available", "complete": true,
  "expectedIntervals": 96, "basis": "full",
  "fullPrice": { "available": true, "reason": null,
    "place": { "gridArea": "791", "gridCompany": "Radius Elnet A/S", "region": "DK2", "ambiguous": false } },
  "current": { "start": "2026-11-11T11:30:00.000Z", "localStart": "2026-11-11T12:30:00+01:00",
    "spot": 2.809068, "spotVat": 3.511335, "full": 4.07, "components": { … } },
  "intervals": [ {
    "start": "2026-11-10T23:00:00.000Z", "end": "2026-11-10T23:15:00.000Z",
    "localStart": "2026-11-11T00:00:00+01:00",
    "spot": 1.725822, "spotVat": 2.157278, "full": 2.443778,
    "components": { "spotExVat": 1.725822, "gridExVat": 0.10616,
                    "tsoAndTaxExVat": 0.12304, "vat": 0.488756 } }, … ],
  "hours": [ { "start": "…", "spot": 1.622906, "spotVat": 2.028633, "full": 2.315133 }, … ],
  "summary": { "basis": "full", "average": 3.593005, "cheapest": { … }, "mostExpensive": { … }, "savingsDkk": 3.45 },
  "publication": { "expectedLocalTime": "13:00–15:00", "guaranteed": false },
  "cache": { "spot": { "fetchedAt": "…", "stale": false, "warning": null }, "tariff": { … } },
  "sources": [ { "name": "Energinet · Energi Data Service", "license": "CC BY 4.0", … } ]
}

{ "error": { "code": "UPSTREAM_UNAVAILABLE", "message": "…", "retryAfterSeconds": 60 } }
400
409
422
503

BACKEND.md