EnergyLive API Documentation

Overview

The EnergyLive API provides programmatic access to energy data, allowing developers to download data from the EnergyLive database. This API enables integration with various applications to access and utilize energy market data.

Base URL

The base URL for all API endpoints is:

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

Authentication

All API requests require authentication using the access-token parameter. To obtain an access token, sign up on the EnergyLive platform and generate the token through the User Account page in the following link:

User Account

Include the access-token as a query parameter in your API requests.

Endpoints

1. Get DAM Results

Endpoint:

GET /dam-results

Description: Fetches the Day-Ahead Market (DAM) results as they appear on the homepage of the platform.

Parameters:

• access-token (required): API access token.

Example:

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

2. Get Daily Base and Peak Averages

Endpoint:

GET /daily-avg

Description: Fetches daily base and peak average values with percentage change for a specified country (up to three areas).

Parameters:

• area (required): Desired countries/areas.
• date (optional): Date for the data (format: YYYY-MM-DD). For basic subscriptions, limited to today or tomorrow; for full subscriptions, any date.

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

3. Get Hourly Data

Endpoint:

GET /

Description: Fetches hourly data for specified areas and parameters.

Parameters:

• area (required): Desired countries/zones separated by commas (e.g., BG,GR,IT_PUN,HR).
• param (required): Desired parameters separated by commas (e.g., price, volume).
• from (optional): Start date in datetime format YYYY-MM-DD (CET timezone).
• to (optional): End date in datetime format YYYY-MM-DD (CET timezone).

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=all&param=volume&from=2022-05-01
https://www.energylive.cloud/api/v1?access-token=XXXXXXX&area=all&param=all

Available Data

Currently, the data available for download includes:

• Hourly Prices for the following countries/zones:
  • GR, BG, RO, HU, SK, CZ, RS, TR, HR, SI, FR, CH, AT, DE-LU, ES, PT, ES-PT, BE, GB, NL, IE, PL, EE, LV, LT, FI, NO1, NO2, NO3, NO4, NO5, SE1, SE2, SE3, SE4, DK1, DK2, NI, AL, KS, ME, MK, IT_PUN, IT_NAT, IT_TOTAL, IT_CNOR, IT_CSUD, IT_NORD, IT_SARD, IT_SICI, IT_SUD, IT_CALA
• Hourly Volumes for the following countries/zones:
  • GR, BG, RO, HU, RS, TR, HR, SI, FR, CH, AT, DE-LU, ES-PT, ES-PT, BE, GB, NL, PL, NI, AL, KS, ME, MK, IT_NAT, IT_TOTAL, IT_CNOR, IT_CSUD, IT_NORD, IT_SARD, IT_SICI, IT_SUD, IT_CALA

Error Handling

All error responses will return a JSON object with the following structure:

{
    "status": "error",
    "message": "Error message detailing the issue."
}

Rate Limiting

To ensure fair usage, the API implements rate limiting. The limit is 60 requests per minute. Exceeding this limit will result in a 429 Too Many Requests response.