elpriser.org API

Hovedpunkter

• Ingen nøgle, ingen fast rate limit — Cloudflare-edge cacher svarene, så hyppige kald koster ikke noget. De giver bare det samme svar.
• Hvor ofte skal du spørge? Priserne ændrer sig få gange i døgnet:
  • /api/now og /api/schedule skifter ved hver hele time (Cache-Control: max-age er sekunderne til næste time). Spørg en gang i timen, et minut eller to over, og ikke oftere end hvert 5. minut.
  • /api/prices for i dag ligger fast hele dagen: hent den en gang efter midnat. I morgen-priserne offentliggøres omkring kl. 12.30-13.00 og ændres aldrig bagefter: hent dem fra kl. 13, gentag hvert 1-5. minut, til priserne er der, og stop så.
  • /api/prices for en dag, der er gået, er uforanderlig: hent den en gang og gem den.
  • /api/forecast ændres højst nogle få gange i døgnet: en gang i timen er rigeligt.
  • Respektér Cache-Control og Age, og vent Retry-After sekunder efter et 503 i stedet for at gentage i en løkke. "Upstream rate limit" betyder, at Energi Data Service afviste vores egen forespørgsel om en dag, der endnu ikke ligger i arkivet. Det går over efter sekunder til minutter.
  • Hver forskellig start/end eller date er sin egen cache-post og rammer oftere Energi Data Service end standardvinduet. Bed om ét interval i stedet for ét kald pr. dag.
• Fuld CORS (Access-Control-Allow-Origin: *) — kald direkte fra en webapp uden proxy.
• Send en User-Agent — Cloudflares botbeskyttelse svarer 403 på Pythons standard-urllib (Python-urllib/3.x). Alt andet virker: curl, requests eller dit eget, fx my-app/1.0. I Python: Request(url, headers={"User-Agent": "my-app/1.0"}).
• OpenAPI 3.1 spec på /api/openapi.json — importér i Postman, Bruno eller en ChatGPT/MCP-klient.
• Tibber-kompatibel JSON for HA / Shelly via /api/shelly/tariff.
• Discovery: hver /api/*-response sender et Link: </api/openapi.json>; rel="describedby" header.

Endpoints

Priser, afgifter og tariffer

mode bestemmer, hvad der er lagt oven i spotprisen. Et ukendt mode afvises med 400 — det bliver ikke tavst til spot inkl. moms.

• spot_ex / spot_inkl — ren spotpris, uden og med moms.
• inkl_alt — spot + systemtarif + transmissionstarif + elafgift, inkl. moms.
• inkl_alt_minus — som ovenfor, men uden elafgift.
• net_inkl_tarif / net_inkl_alt — med nettarif; net_inkl_alt er den fulde forbrugerpris. Kræver gln.
• inkl_alt_elvarme / net_inkl_alt_elvarme — bruger den reducerede elafgift for forbrug over 4.000 kWh/år i elopvarmede boliger. Forskellen er stor: 0,8 mod 72,0 øre/kWh i 2025.

Nettariffen hentes for den dato, der spørges om — med tidsbånd og sommer-/vinterforskel. Netselskabet vælges med gln; bemærk at fx N1 optræder som tre selvstændige netområder med hver sin GLN og hver sine satser. Svaret oplyser grid_tariff: hourly, flat for selskaber der kun udgiver én døgnsats, eller null hvis selskabet ikke har udgivet nogen — og så er dagens priser null frem for at mangle tariffen i tavshed.

charges afgør, hvilke satser en historisk dato prissættes med. historical (default) bruger de satser, der faktisk gjaldt på datoen. current omregner samme prisforløb til nutidens satser — nyttigt til at sammenligne år, men det er ikke, hvad timen kostede.

Eksempel — curl

curl -sS "https://elpriser.org/api/now?area=DK1&mode=inkl_alt"

Returnerer:

{
  "on": true,
  "price": 1.23,
  "hour": 14,
  "area": "DK1",
  "mode": "inkl_alt",
  "strategy": "cheapest_n"
}

Brug i LLM / AI-agent

Spørg en LLM "hvad er elprisen lige nu i Danmark?" og giv den denne URL:

https://elpriser.org/api/now?area=DK1&mode=inkl_alt

For Claude Desktop, ChatGPT plugins, og MCP-klienter kan du pege på OpenAPI-spec'en på /api/openapi.json — den indeholder alle endpoints og parametre.

{
  "mcpServers": {
    "elpriser": { "command": "npx", "args": ["-y", "elpriser-mcp"] }
  }
}

import { createElpriserClient } from 'elpriser-client';
const elpriser = createElpriserClient();
const nu = await elpriser.now({ area: 'DK1' });

Vilkår

• Gratis for ethvert brug (kommercielt eller ej)
• Datakilde: Energi Data Service (Energinet) — egen licens
• Best-effort uptime — ingen SLA. Edge-cacher graceful, så kortvarige udfald hos EDS påvirker ikke API'et
• Spørgsmål / fejl: brug GitHub-issues (link i footeren) eller skriv direkte