Дані безпосередньо з платформи
Той самий шар, який читають сторінки самого сайту. Без ключа, без реєстрації, JSON через HTTP. Кожна відповідь каже, з якого джерела вона походить, до якого моменту належить і наскільки свіжа.
Енергосистема в реальному часі
Споживання, виробництво за джерелами і транскордонний обмін — так, як їх публікують оператори систем передачі. Відкрито.
| Адреса | Що повертає | Частота |
|---|---|---|
/api/v1/countries |
Усі країни на платформі з їхніми зонами і статусом покриття. | Змінюється рідко — коли змінюється реєстр. |
/api/v1/countries/:iso2/latest |
Знімок країни: споживання, виробництво за джерелами, сальдо на кордонах. | Так часто, як публікує її оператор, — від 10 секунд до години. |
/api/v1/countries/:iso2/history |
Часовий ряд для однієї країни за обраний проміжок. | Та сама частота, що й у знімка. |
/api/v1/europe/latest |
Європейський підсумок і кожна країна, що до нього входить. | Одна хвилина. |
/api/v1/status |
Стан збирання даних: яке джерело публікувало останнім і коли. | Безперервно. |
/api/v1/licenses |
Що платформі дозволено робити з даними кожного джерела. | Коли змінюються умови джерела. |
/api/v1/search |
Пошук за країнами, зонами і термінами. | Безперервно. |
Ринок «на добу наперед»
Ціни, визначені на аукціоні на наступну добу, за торговими зонами. Поки що закрито — чому, див. нижче.
| Адреса | Що повертає | Частота |
|---|---|---|
/api/v1/prices/latest451 · ліцензія |
Остання відома ціна для кожної зони. | Раз на добу, після аукціону. |
/api/v1/prices/zones451 · ліцензія |
Торгові зони з часовим поясом і валютою кожної. | Змінюється рідко. |
/api/v1/prices/date451 · ліцензія |
Усі зони на обрану добу постачання. | Щодня. |
/api/v1/prices/country/:iso2451 · ліцензія |
Ціни країни для кожної з її зон. | Щодня. |
/api/v1/prices/:zone/history451 · ліцензія |
Історія зони, інтервал за інтервалом. | Щодня. |
/api/v1/prices/:zone/summary451 · ліцензія |
Середнє, мінімум, максимум і квантилі за день, тиждень або місяць. | Щодня. |
/api/v1/market/cheapest451 · ліцензія |
Зони з найнижчою середньою ціною дня. | Щодня. |
/api/v1/market/expensive451 · ліцензія |
Зони з найвищою середньою ціною дня. | Щодня. |
/api/v1/market/spreads451 · ліцензія |
Різниця між найдешевшою і найдорожчою годиною за зонами. | Щодня. |
/api/v1/market/cheapest-window451 · ліцензія |
Найдешевше безперервне вікно тривалістю N годин у зоні. | Щодня. |
/api/v1/market/weekly451 · ліцензія |
Щотижневий звіт після закриття тижня. | Щотижня. |
Чому цінові маршрути відповідають кодом 451
Ринкові дані надходять із платформи прозорості ENTSO-E. Ми збираємо їх і показуємо на сайті із джерелом поряд із кожною цифрою, але поширювати їх через API — не те саме, що показувати, а умови повторного використання ми ще не перевірили й не зареєстрували.
Доти цінові маршрути повертають 451 — код для «недоступно з правових причин», — а не тихо віддають те, що ми не маємо права віддавати. Система ліцензування працює для кожного джерела окремо, а не для кожної країни, тож щоб їх відкрити, не треба змінювати код.
Правила доброї поведінки
Обмеження кількості запитів немає, і ми хотіли б, щоб воно й не знадобилося. Відповіді містять cache-control: дотримуйтеся його — і отримаєте ті самі цифри, не питаючи двічі. Дані в реальному часі не змінюються частіше, ніж їх публікує оператор: запит щосекунди для країни, що публікує щогодини, нічого нового не дасть.
Якщо ви використовуєте дані публічно, посилайтеся на першоджерело (оператора системи передачі або ENTSO-E), а не на нас: ми їх переносимо, а не виробляємо.
Див. також: Джерела даних · Методика · Стан системи · llms.txt