v2

latestOpenAPI 3.1.0Publishing notes2026-08-04372580.6 KB
import_export v2

Cross-border electricity trading (scheduled commercial exchanges)

Cross-border electricity trading (scheduled commercial exchanges) in gigawatt (GW) between a country and each of its neighbors, plus a 'sum' series. Positive values are imports, negative values exports. Accepted formats: ISO 8601 (2026-01-01T17:00Z), day (2026-01-01, interpreted in the local timezone) or unix seconds (1767222000). Empty start defaults to today; empty end defaults to start.

get/v2/cbet

Query parameters

country'ch' | 'eu' | 'all' | 'at' | 'ba' | 'be' | 'bg' | 'cy' | 'cz' | 'de' | 'dk' | 'ee' | 'es' | 'fi' | 'fr' | 'ge' | 'gr' | 'hr' | 'hu' | 'ie' | 'it' | 'lt' | 'lu' | 'lv' | 'md' | 'me' | 'mk' | 'nl' | 'no' | 'pl' | 'pt' | 'ro' | 'rs' | 'se' | 'si' | 'sk' | 'ua' | 'uk' | 'xk'

ISO-like country code accepted by the Energy-Charts API.

Country code

startstring

Accepted formats: ISO 8601 (2026-01-01T17:00Z), day (2026-01-01, interpreted in the local timezone) or unix seconds (1767222000). Empty start defaults to today; empty end defaults to start.

Accepted formats: ISO 8601 (2026-01-01T17:00Z), day (2026-01-01, interpreted in the local timezone) or unix seconds (1767222000). Empty start defaults to today; empty end defaults to start.

endstring

Accepted formats: ISO 8601 (2026-01-01T17:00Z), day (2026-01-01, interpreted in the local timezone) or unix seconds (1767222000). Empty start defaults to today; empty end defaults to start.

Accepted formats: ISO 8601 (2026-01-01T17:00Z), day (2026-01-01, interpreted in the local timezone) or unix seconds (1767222000). Empty start defaults to today; empty end defaults to start.

Response

Successful Response

schema_versionstring required

Version of this response schema.

endpointstring required

Name of the endpoint that produced this response.

countrystring nullable

Country code the data refers to (lowercase), if applicable.

bidding_zonestring nullable

Bidding zone the data refers to, if applicable.

timezonestring required

IANA timezone in which all timestamps of this response are expressed.

resolutionstring nullable

Temporal resolution as ISO 8601 duration (e.g. PT15M, PT1H, P1D, P1M, P1Y). null if the time axis is irregular.

interval_minutesinteger nullable

Temporal resolution in minutes. null if irregular or if the step is calendar based (months / years).

unitstring nullable

Default unit of all series. Individual series may override it via series[*].unit.

generated_atstring required

ISO 8601 time at which this response body was generated. Responses may be served from a short-lived cache; this field always reflects the true generation time.

available_fromstring nullable

Timestamp of the first record that contains at least one non-null value. null if the response is empty.

available_untilstring nullable

Timestamp of the last record that contains at least one non-null value (data availability at generation time). null if the response is empty.

attributesobject

Endpoint specific metadata (e.g. forecast_type).

licensestring nullable

License of the data in this response.

deprecatedboolean required

True if this endpoint is scheduled for discontinuation.

Example response

{
  "attributes": {},
  "available_from": "2026-07-20T00:00:00+02:00",
  "available_until": "2026-07-20T19:30:00+02:00",
  "country": "de",
  "data": [
    {
      "timestamp": "2026-07-20T12:00:00+02:00",
      "values": {
        "renewable_share_of_load": 61.4,
        "solar": 42135.7,
        "wind_onshore": 18421.3
      }
    },
    {
      "timestamp": "2026-07-20T12:15:00+02:00",
      "values": {
        "renewable_share_of_load": 62,
        "solar": 42891.2,
        "wind_onshore": 18154.8
      }
    }
  ],
  "deprecated": false,
  "endpoint": "public_power",
  "generated_at": "2026-07-20T19:45:00+02:00",
  "interval_minutes": 15,
  "license": "CC BY 4.0 (creativecommons.org/licenses/by/4.0), attribution: energy-charts.info",
  "resolution": "PT15M",
  "schema_version": "2.0",
  "series": [
    {
      "id": "solar",
      "name": "Solar"
    },
    {
      "id": "wind_onshore",
      "name": "Wind onshore"
    },
    {
      "id": "renewable_share_of_load",
      "name": "Renewable share of load",
      "unit": "%"
    }
  ],
  "timezone": "Europe/Berlin",
  "unit": "MW"
}