Běžné REST API: jedna adresa, klíč v hlavičce, odpovědi v JSON. Každý endpoint si můžete vyzkoušet rovnou tady na stránce, ještě než napíšete první řádek kódu.
Základní URL
https://api.spotforecast.eu/v1Autentizační hlavička
Authorization: Bearer YOUR_KEYKlíč posílejte v hlavičce, ne v adrese. Co je v adrese, to skončí v logu každého serveru po cestě a zůstane v historii prohlížeče - klíč se tak může dostat na místa, která nespravujete a kde by se dostat neměla.
curl -H "Authorization: Bearer YOUR_KEY" \
"https://api.spotforecast.eu/v1/forecast?zone=CZ&horizon=7&unit=EUR/MWh"/v1/zonesBez klíčePublic. 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žadavku
https://api.spotforecast.eu/v1/zonesOdpověď
Vyplňte parametry a odešlete požadavek - odpověď se ukáže tady.Ceny jsou uvedeny v EUR/MWh, pokud si v API požadavku neřeknete o jinou jednotku. V každé odpovědi je uvedeno, v jakých jednotkách ceny jsou. Ceny jsou vždy uvedeny pouze za silovou elektřinu bez daní a dalších fixních poplatků (distribuce, poplatky poskytovatele spotového tarifu atd.).
EUR/MWhVýchozí jednotka. Předpovědní modely v ní počítají na vstupu i na výstupu.EUR/kWhS touto jednotkou pracuje např. evcc.ct/kWhTuhle jednotku používá energetický dashboard v Home Assistantu.Kód použijte v parametru zone.
ALATBEBGHRCZDK2DK1EEFIFRDEGRHUIE-SEMIT-CALAIT-CNORIT-CSUDIT-NORDIT-SARDIT-SICIIT-SUDXKLVLTMENLMKNO1NO2NO3NO4NO5PLPTRORSSKSIESSE1SE2SE3SE4CHData o spotových tržních cenách elektřiny včetně jejich předpovědí se řídí místním časem dané zóny. Časová razítka jsou uváděna 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 posíláme ve formátu problem details (RFC 9457). Každá má pole type s odkazem na stránku, kde je popsaná. Texty chyb jsou anglicky.
Založte si účet přes e-mail a vytvořte si klíč na stránce účtu.
V odpovědi na požadavek přijde chyba 429 s hlavičkou Retry-After, která říká, kdy se okno resetuje. V každé API odpovědi je navíc k dispozici údaj o zbývajícím počtu požadavků.
K backtestům. Zeptáte se na minulé datum a dostanete předpověď, jak pro ten den vypadala. Kromě toho si můžete sami vyhodnotit, jak jsou naše modely přesné a zda vyhovují vašemu účelu.
Modely počítají předpověď standardně v hodinových intervalech a 15minutové intervaly jsou dopočítané interpolací. Skutečné tržní ceny jsou k dispozici rovněž v obou variantách.
Výchozí jednotka je EUR/MWh, ale můžete si v API požadavku zvolit také EUR/kWh nebo ct/kWh - odpověď vždy jednotku uvádí. Pro implementaci do různých chytrých řídicích systémů se může hodit jiná jednotka.
Pro každou zónu v Evropě může být přesnost odlišná, protože každá zóna má svá specifika. V některých zónách je přesnost velmi vysoká, v jiných však na zvýšení přesnosti modelů stále pracujeme. Nepřesnost předpovědí hodnotíme v MAE (Mean Absolute Error) a tato hodnota je dostupná v grafu předpovědi pro každou zónu a den. Kromě předpovědní křivky dáváme také pásmo ohraničené percentily P10-P90, které navíc ukazuje, jak se reálná tržní cena může v extrémech vychýlit od předpovědi.