Bežné REST API: jedna adresa, kľúč v hlavičke, odpovede v JSON. Každý endpoint si môžete vyskúšať priamo tu na stránke, ešte predtým, než napíšete prvý riadok kódu.
Základná URL
https://api.spotforecast.eu/v1Autentifikačná hlavička
Authorization: Bearer YOUR_KEYKľúč posielajte v hlavičke, nie v adrese. Čo je v adrese, to skončí v logu každého servera po ceste a zostane v histórii prehliadača - kľúč sa tak môže dostať na miesta, ktoré nespravujete a kam by sa dostať nemal.
curl -H "Authorization: Bearer YOUR_KEY" \
"https://api.spotforecast.eu/v1/forecast?zone=CZ&horizon=7&unit=EUR/MWh"/v1/zonesBez kľúčaPublic. Lists the bidding zones we serve: has_forecast says whether a forecast exists for each, latest_as_of_utc carries the time of the last run and is null where nothing has been published for that zone yet.
URL požiadavky
https://api.spotforecast.eu/v1/zonesOdpoveď
Vyplňte parametre a odošlite požiadavku - odpoveď sa ukáže tu.Ceny sú uvedené v EUR/MWh, pokiaľ si v API požiadavke nevypýtate inú jednotku. V každej odpovedi je uvedené, v akých jednotkách ceny sú. Ceny sú vždy uvedené len za silovú elektrinu bez daní a ďalších fixných poplatkov (distribúcia, poplatky poskytovateľa spotovej tarify a podobne).
EUR/MWhPredvolená jednotka. Predpovedné modely v nej počítajú na vstupe aj na výstupe.EUR/kWhS touto jednotkou pracuje napr. evcc.ct/kWhTúto jednotku používa energetický dashboard v Home Assistante.Kód použite v parametri zone.
ALATBEBGHRCZDK2DK1EEFIFRDEGRHUIE-SEMIT-CALAIT-CNORIT-CSUDIT-NORDIT-SARDIT-SICIIT-SUDXKLVLTMENLMKNO1NO2NO3NO4NO5PLPTRORSSKSIESSE1SE2SE3SE4CHÚdaje o spotových trhových cenách elektriny vrátane ich predpovedí sa riadia miestnym časom danej zóny. Časové značky sú uvádzané vždy v UTC.
{
"zone": "CZ",
"as_of_utc": "2026-08-10T13:00:00Z",
"model_version": "v3-CZ-D7-20260810-0835",
"unit": "EUR/MWh",
"resolution": "PT60M",
"horizon_days": 7,
"points": [
{
"start": "2026-08-10T22:00:00Z",
"value": 141.86,
"p10": 112.9,
"p90": 205.06,
"origin": "forecast"
}
],
"attribution": {
"market_data": "Source of underlying market data: ENTSO-E Transparency Platform."
}
}Chyby posielame vo formáte problem details (RFC 9457). Každá má pole type s odkazom na stránku, kde je popísaná. Texty chýb sú anglicky.
Založte si účet cez e-mail a vytvorte si kľúč na stránke účtu.
V odpovedi na požiadavku príde chyba 429 s hlavičkou Retry-After, ktorá hovorí, kedy sa okno resetuje. V každej API odpovedi je navyše k dispozícii údaj o zostávajúcom počte požiadaviek.
Na backtesty. Spýtate sa na minulý dátum a dostanete predpoveď tak, ako pre ten deň vyzerala. Okrem toho si sami vyhodnotíte, aké presné sú naše modely a či vyhovujú vášmu účelu.
Modely počítajú predpoveď štandardne v hodinových intervaloch a 15-minútové intervaly sú dopočítané interpoláciou. Skutočné trhové ceny sú k dispozícii rovnako v oboch variantoch.
Predvolená jednotka je EUR/MWh, ale v API požiadavke si môžete zvoliť aj EUR/kWh alebo ct/kWh - odpoveď jednotku vždy uvádza. Pri implementácii do rôznych inteligentných riadiacich systémov sa môže hodiť iná jednotka.
Pre každú zónu v Európe môže byť presnosť odlišná, pretože každá zóna má svoje špecifiká. V niektorých zónach je presnosť veľmi vysoká, v iných však na zvýšení presnosti modelov stále pracujeme. Nepresnosť predpovedí hodnotíme v MAE (Mean Absolute Error) a táto hodnota je dostupná v grafe predpovede pre každú zónu a deň. Okrem predpovednej krivky dávame aj pásmo ohraničené percentilmi P10-P90, ktoré navyše ukazuje, ako sa reálna trhová cena môže v extrémoch vychýliť od predpovede.