EnergyLive API Documentation

Overview

The EnergyLive API provides programmatic access to Day-Ahead Market (DAM) data stored in the EnergyLive database, so that it can be integrated into your own applications, models and reports.

All responses are JSON. All dates are in the format YYYY-MM-DD and refer to the CET/CEST delivery day (Europe/Berlin).

Base URL

https://www.energylive.cloud/api/v1/

Authentication

Every request must be authenticated with your personal API token. You can generate (and regenerate) the token on your User Account page.

Send the token in one of the following ways:

• As the query parameter access-token:

  https://www.energylive.cloud/api/v1/dam-results?access-token=XXXXXXXX

• As an HTTP header (recommended, keeps the token out of URLs and logs):

  Authorization: Bearer XXXXXXXX

Keep your token secret. If it may have been exposed, regenerate it from your User Account page.

Subscription access

"Historical" means any delivery day before today (CET). Requests for historical data without the required subscription return an error (see Error handling). With area=all, Italian zones are omitted from historical results when the subscription does not include GME data.

Endpoints

1. Get DAM Results

GET /dam-results

Returns the Day-Ahead Market results for all areas, as they appear on the platform's home page: base, peak and off-peak averages of the delivery day, plus month-to-date and year-to-date averages. By default the latest delivery day; with date, the results of an earlier day.

Parameters:

Examples:

https://www.energylive.cloud/api/v1/dam-results?access-token=XXXXXXXX
https://www.energylive.cloud/api/v1/dam-results?access-token=XXXXXXXX&date=2025-01-15

Response:

{
    "date": "2026-09-28",
    "results": [
        {"code": "gr", "name": "Greece (GR)", "base": 135.108, "peak": 82.014, "offpeak": 188.201, "mtd": 159.208, "ytd": 105.969},
        ...
    ],
    "currency": "EUR",
    "rate_GBP": 0.84,
    "updated_CET": "2026-09-27 13:05:12",
    "updated_ts": 1790507112
}

• All values are in EUR/MWh. GB prices are converted from GBP with the ECB reference rate of each delivery day (a day without a rate, e.g. a weekend, takes the last rate before it): base, peak and offpeak with the rate of the day (rate_GBP, EUR/GBP), mtd and ytd day by day.
• peak: average of 08:00–20:00 CET; offpeak: the remaining hours.

2. Get Daily Base and Peak Averages

GET /daily-avg

Returns daily base and peak average prices, with the relative change from the previous day, for up to three areas.

Parameters:

Examples:

https://www.energylive.cloud/api/v1/daily-avg?access-token=XXXXXXXX&area=GR,BG
https://www.energylive.cloud/api/v1/daily-avg?access-token=XXXXXXXX&area=BG,RO,HU&date=2022-11-10

Response:

[
    {"area": "GR", "date": "2026-09-28", "base": 135.11, "base_change": 0.328, "peak": 82.01, "peak_change": 1.1843},
    ...
]

• base: average price of the day (EUR/MWh). peak: average of 08:00–20:00 CET.
• base_change, peak_change: change vs. the previous day as a fraction (0.328 = +32.8%).
• A field is an empty string "" when the value cannot be computed (e.g. no data for the previous day, or the previous value is 0).
• If there is no data for the requested day (e.g. a future date), the response is an empty array [].

3. Get Time Series (prices and volumes)

GET /

Returns DAM prices and/or volumes for the requested areas and delivery period.

Since the move of the European Day-Ahead Market to a 15-minute Market Time Unit (1 October 2025), data is returned in 15-minute resolution (96 values per day; 92/100 on daylight-saving change days). Use averaging=hour to receive hourly averages instead. Earlier periods are available in the resolution in which they were published (hourly).

Parameters:

Examples:

https://www.energylive.cloud/api/v1?access-token=XXXXXXX&area=BG,RO,GR,DE-LU,HU&param=price&from=2022-05-01&to=2022-05-10
https://www.energylive.cloud/api/v1?access-token=XXXXXXX&area=GR&param=price,volume&from=2026-09-01&to=2026-09-07&averaging=hour
https://www.energylive.cloud/api/v1?access-token=XXXXXXX&area=all&param=all
https://www.energylive.cloud/api/v1?access-token=XXXXXXX&area=all&param=price&page=2

Response:

[
    {"name": "GR_price", "date_local": "2026-09-28", "hour_local": 1, "minute_local": 0,  "datetime_CET": "2026-09-28 00:00:00", "value": 192.07},
    {"name": "GR_price", "date_local": "2026-09-28", "hour_local": 1, "minute_local": 15, "datetime_CET": "2026-09-28 00:15:00", "value": 188.72},
    ...
]

• name: series name, <AREA>_price (EUR/MWh) or <AREA>_volume (MWh).
• datetime_CET: start of the delivery period in CET/CEST. This is the recommended timestamp to use.
• date_local, hour_local (1–24, hour ending), minute_local (0, 15, 30, 45): delivery day, hour and quarter.
• Rows are ordered by series and then by time. If to is before from, the response is an empty array.

Pagination

The time-series endpoint returns at most 1,000 rows per request. Always check the following response headers and request the next pages with page=2, page=3, … until all rows have been received:

For example, one day of area=all&param=price in 15-minute resolution is about 4,000 rows (5 pages).

Available areas

Error handling

Request errors (invalid parameters, subscription restrictions, no data) are returned with HTTP status 200 and the following JSON body. Check the status field of the body:

{
    "name": "Bad Request",
    "message": "You do not have access to historical data.",
    "code": 0,
    "status": 400
}

The following errors are returned with the corresponding HTTP status code and the same body structure:

Rate limiting

The API allows 60 requests per minute per account. Exceeding this limit results in a 429 Too Many Requests response; wait a few seconds and retry.

Requests with an invalid or missing token are limited per IP address: after 10 failed requests within one minute, all requests from that IP address receive 429 Too Many Requests for 15 minutes (see the Retry-After header). Do not retry requests that return 401; check the token instead.