Zwykłe REST API: jeden adres, klucz w nagłówku, odpowiedzi w JSON. Każdy endpoint możesz wypróbować od razu na tej stronie, zanim napiszesz pierwszą linijkę kodu.
Adres bazowy
https://api.spotforecast.eu/v1Nagłówek uwierzytelniający
Authorization: Bearer YOUR_KEYKlucz wysyłaj w nagłówku, nie w adresie. Co jest w adresie, trafi do logu każdego serwera po drodze i zostanie w historii przeglądarki - klucz może w ten sposób trafić w miejsca, których nie kontrolujesz i w których nie powinien się znaleźć.
curl -H "Authorization: Bearer YOUR_KEY" \
"https://api.spotforecast.eu/v1/forecast?zone=CZ&horizon=7&unit=EUR/MWh"/v1/zonesBez kluczaPublic. 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.
Adres zapytania
https://api.spotforecast.eu/v1/zonesOdpowiedź
Wypełnij parametry i wyślij zapytanie - odpowiedź pojawi się tutaj.Ceny są podawane w EUR/MWh, chyba że w żądaniu API poprosisz o inną jednostkę. Każda odpowiedź podaje, w jakiej jednostce są jej ceny. Ceny dotyczą zawsze wyłącznie samej energii, bez podatków i innych stałych opłat (dystrybucja, opłaty dostawcy taryfy spot i tak dalej).
EUR/MWhJednostka domyślna. Modele prognostyczne liczą w niej na wejściu i na wyjściu.EUR/kWhW tej jednostce pracuje np. evcc.ct/kWhTej jednostki używa panel energii w Home Assistancie.Kodu użyj w parametrze zone.
ALATBEBGHRCZDK2DK1EEFIFRDEGRHUIE-SEMIT-CALAIT-CNORIT-CSUDIT-NORDIT-SARDIT-SICIIT-SUDXKLVLTMENLMKNO1NO2NO3NO4NO5PLPTRORSSKSIESSE1SE2SE3SE4CHDane o cenach spot energii elektrycznej wraz z prognozami są liczone według czasu lokalnego danej strefy. Znaczniki czasu są zawsze podawane w 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."
}
}Błędy wysyłamy w formacie problem details (RFC 9457). Każdy ma pole type z odnośnikiem do strony, na której jest opisany. Teksty błędów są po angielsku.
Załóż konto przez e-mail i utwórz klucz na stronie konta.
W odpowiedzi na żądanie przyjdzie błąd 429 z nagłówkiem Retry-After, który mówi, kiedy okno się zresetuje. W każdej odpowiedzi API jest ponadto informacja o pozostałej liczbie żądań.
Do backtestów. Pytasz o przeszłą datę i dostajesz prognozę w takiej postaci, jaką miała na tamten dzień. Poza tym możesz też ocenić, jak dokładne są nasze modele i czy odpowiadają twoim potrzebom.
Modele liczą prognozę standardowo w interwałach godzinowych, a interwały 15-minutowe są wyliczane przez interpolację. Rzeczywiste ceny rynkowe są dostępne w obu wariantach.
Domyślna jednostka to EUR/MWh, ale w żądaniu API możesz wybrać też EUR/kWh lub ct/kWh - odpowiedź zawsze podaje jednostkę. Przy integracji z inteligentnymi systemami sterowania inna jednostka bywa wygodniejsza.
Dokładność może się różnić dla każdej strefy w Europie, bo każda strefa ma swoją specyfikę. W niektórych strefach jest bardzo wysoka, w innych wciąż pracujemy nad poprawą modeli. Błąd mierzymy jako MAE (Mean Absolute Error), a wartość jest dostępna na wykresie prognozy dla każdej strefy i dnia. Poza krzywą prognozy dajemy też pasmo wyznaczone percentylami P10-P90, które dodatkowo pokazuje, jak bardzo rzeczywista cena rynkowa może w skrajnych przypadkach odchylić się od prognozy.