OpenAPI Specification
openapi: 3.1.0
info:
title: Energy-Charts import_export prices API
description: "\n \n\n<h4>Timestamp Format Options</h4>\n <p>When specifying timestamps, you can choose from the following three formats:</p>\n <ol>\n <li><strong>ISO 8601 Format</strong>:\n <ul>\n <li>This format includes the full date and time, with an optional timezone indicator.</li>\n <li>Examples:\n <ul>\n <li><code>2025-01-01T17:00Z</code> (UTC time)</li>\n <li><code>2025-01-01T18:00+01:00</code> (Local time offset by +01:00)</li>\n </ul>\n </li>\n </ul>\n </li>\n <li><strong>Daily Format</strong>:\n <ul>\n <li>This format specifies only the date.</li>\n <li>The start time is assumed to be at 00:00 on the specified date in the local timezone of the specified country or bidding zone (bzn).</li>\n <li>The end timestamp is interpreted as the last minute of the specified day in the same local timezone.</li>\n <li>Example:\n <ul>\n <li><code>2025-01-01</code> (Starts at 00:00 and ends at 23:59 on January 1, 2025, local time)</li>\n </ul>\n </li>\n </ul>\n </li>\n <li><strong>UNIX Timestamp</strong>:\n <ul>\n <li>This format specifies the time as the number of seconds since the Unix Epoch (January 1st, 1970, at 00:00 UTC).</li>\n <li>Example:\n <ul>\n <li><code>1735686000</code></li>\n </ul>\n </li>\n </ul>\n </li>\n </ol>\n <h4>Default Behavior for Timestamps</h4>\n <p>If an end timestamp is not explicitly provided, it is assumed to be the same as the start timestamp. For daily formats, this means that one full day will be returned. If also no start timestamp is provided, the current day in the local timezone is used.</p>\n <h4>Discontinuation of endpoints</h4>\n <p>Endpoint discontinuations will be preceded by an announcement at least six months in advance, indicated by setting the \"deprecated\" status to true.</p>\n <h4>Data License</h4>\n <p>Unless stated otherwise, the data provided by the Energy-Charts API is licensed under the <a href=\"https://creativecommons.org/licenses/by/4.0/\" target=\"_blank\">CC BY 4.0</a> license. Proper attribution to Energy-Charts.info as the source is required.</p>\n <details>\n <summary><b>New in release v1.5 (2025-10-21)</b></summary>\n <ul>\n <li>\n Include stricter rate limitations for public API\n (please contact <a href=\"mailto:leonhard.gandhi@ise.fraunhofer.de\">leonhard.gandhi@ise.fraunhofer.de</a> for commercial access)\n </li>\n <li>Improved load balancing on concurrent requests</li>\n </ul>\n </details>\n <details>\n <summary><b> Older Releases </b></summary>\n <details>\n <summary><b>v1.4 (2024-07-08)</b></summary>\n <ul>\n <li>Fix bug with wrong timezone for unix timestamps as input</li>\n </ul>\n </details> \n <details>\n <summary><b>v1.3 (2024-04-22)</b></summary>\n <ul>\n <li>Fix bug which hid most recent data for /cbet and /cbpf</li>\n <li>Inlcude deprecated tag to all active endpoints</li>\n </ul>\n </details>\n <details>\n <summary><b>v1.2 (2024-04-16)</b></summary>\n <ul>\n <li>Allow also input timestamps in day format and UNIX timestamp</li>\n <li>Inlcude license info for price data available at /price</li>\n </ul>\n </details>\n <details>\n <summary><b>v1.1 (2023-10-20)</b></summary>\n <ul>\n <li>Deprecated /ren_share</li>\n <li>Deprecated /ren_share_prognosis and replaced it with /ren_share_forecast</li>\n <li>Deprecated /power and replaced it with /public_power</li>\n <li>Deprecated /price_spot_market and replaced it with /price</li>\n <li>Deprecated /traffic_signal and replaced it with /signal</li>\n <li>Added endpoint for cross-border electricity trading (/cbet)</li>\n <li>Added endpoint for cross-border physical flow (/cbpf)</li>\n <li>Changed response structure of all endpoints to fit with json specification</li>\n <li>Simplified the response json structure</li>\n <li>Removed unnecessary information from responses like names, descriptions and units</li>\n <li>Added typed response schemes to every endpoint</li>\n <li>Added example values and example requests to every endpoint</li>\n <li>Added postal code to /signal, to consider grid state in future implementations</li>\n <li>Responses that return unix timestamps now all return unix seconds</li>\n <li>Added error handling for false requests and responses</li>\n <li>Added a list of available bidding zones for /price</li>\n </ul>\n </details>\n <details>\n <summary><b>v1.0 (2022-11-30)</b></summary>\n <ul>\n <li>Initial release</li>\n </ul>\n </details>\n </details>\n \n\n<b>Available countries:</b>\n \n\n<details><summary>de - Germany (click to show all available countries)</summary>\n ch - Switzerland<br>\n eu - European Union<br>\n all - Europe<br>\n al - Albania<br>\n am - Armenia<br>\n at - Austria<br>\n az - Azerbaijan<br>\n ba - Bosnia-Herzegovina<br>\n be - Belgium<br>\n bg - Bulgaria<br>\n by - Belarus<br>\n cy - Cyprus<br>\n cz - Czech Republic<br>\n dk - Denmark<br>\n ee - Estonia<br>\n es - Spain<br>\n fi - Finland<br>\n fr - France<br>\n ge - Georgia<br>\n gr - Greece<br>\n hr - Croatia<br>\n hu - Hungary<br>\n ie - Ireland<br>\n it - Italy<br>\n lt - Lithuania<br>\n lu - Luxembourg<br>\n lv - Latvia<br>\n md - Moldova<br>\n me - Montenegro<br>\n mk - North Macedonia<br>\n mt - Malta<br>\n nie - North Ireland<br>\n nl - Netherlands<br>\n no - Norway<br>\n pl - Poland<br>\n pt - Portugal<br>\n ro - Romania<br>\n rs - Serbia<br>\n ru - Russia<br>\n se - Sweden<br>\n si - Slovenia<br>\n sk - Slovak Republic<br>\n tr - Turkey<br>\n ua - Ukraine<br>\n uk - United Kingdom<br>\n xk - Kosovo<br>\n </details>\n \n\n<b>Available bidding zones:</b>\n \n\n<details><summary>AT - Austria (click to show all available bidding zones)</summary>\n BE - Belgium<br>\n BG - Bulgaria<br>\n CH - Switzerland<br>\n CZ - Czech Republic<br>\n DE-LU - Germany, Luxembourg<br>\n DE-AT-LU - Germany, Austria, Luxembourg<br>\n DK1 - Denmark 1<br>\n DK2 - Denmark 2<br>\n EE - Estionia<br>\n ES - Spain<br>\n FI - Finland<br>\n FR - France<br>\n GR - Greece<br>\n HR - Croatia<br>\n HU - Hungary<br>\n IT-Calabria - Italy Calabria<br>\n IT-Centre-North - Italy Centre North<br>\n IT-Centre-South - Italy Centre South<br>\n IT-North - Italy North<br>\n IT-SACOAC - Italy Sardinia Corsica AC<br>\n IT-SACODC - Italy Sardinia Corsica DC<br>\n IT-Sardinia - Italy Sardinia<br>\n IT-Sicily - Italy Sicily<br>\n IT-South - Italy South<br>\n LT - Lithuania<br>\n LV - Latvia<br>\n ME - Montenegro<br>\n NL - Netherlands<br>\n NO1 - Norway 1<br>\n NO2 - Norway 2<br>\n NO2NSL - Norway North Sea Link<br>\n NO3 - Norway 3<br>\n NO4 - Norway 4<br>\n NO5 - Norway 5<br>\n PL - Poland<br>\n PT - Portugal<br>\n RO - Romania<br>\n RS - Serbia<br>\n SE1 - Sweden 1<br>\n SE2 - Sweden 2<br>\n SE3 - Sweden 3<br>\n SE4 - Sweden 4<br>\n SI - Slovenia<br>\n SK - Slovakia<br>\n </details>\n \n\n<b>Hint:</b> Don't use the <b>Try it out</b> button on this documentation page to download large datasets as it might lead to long loading times.\n "
termsOfService: https://energy-charts.info/data-protection.html
contact:
name: Contact
url: https://energy-charts.info/contact.html
license:
name: Publishing notes
url: https://energy-charts.info/publishing-notes.html
version: '1.5'
tags:
- name: prices
description: Query price values
paths:
/price:
get:
tags:
- prices
summary: Day Ahead Price
description: "Returns the day-ahead spot market price for a specified bidding zone in EUR/MWh.\n \n\n\n \n\nAvailable bidding zones (bzn) are shown above.\n \n\n\n \n\n<b>The data for the following bidding zones is licensed as <a href=\"https://creativecommons.org/licenses/by/4.0/\" target=\"_blank\">CC BY 4.0</a> from Bundesnetzagentur | SMARD.de and is published without changes:\n <ul>\n <li>AT (Austria)</li>\n <li>BE (Belgium)</li>\n <li>CH (Switzerland)</li>\n <li>CZ (Czech Republic)</li>\n <li>DE-LU (Germany, Luxembourg)</li>\n <li>DE-AT-LU (Germany, Austria, Luxembourg)</li>\n <li>DK1 (Denmark 1)</li>\n <li>DK2 (Denmark 2)</li>\n <li>FR (France)</li>\n <li>HU (Hungary)</li>\n <li>IT-North (Italy North)</li>\n <li>NL (Netherlands)</li>\n <li>NO2 (Norway 2)</li>\n <li>PL (Poland)</li>\n <li>SE4 (Sweden 4)</li>\n <li>SI (Slovenia)\n </ul></b>\n \n\n\n \n\n<b>The data for the other bidding zones is for private and internal use only. The utilization of any data</li>\nwhether in its raw or derived form, for external or commercial purposes is expressly prohibited. Should you require licensing for market-related data, please direct your inquiries to the original data providers, including but not limited to EPEX SPOT SE.</b>\n \n\nResponse schema:\n \n\n```json\n{\n \"license_info\": str,\n \"unix_seconds\": [int],\n \"price\": [float],\n \"unit\": str,\n \"deprecated\": bool\n}\n```"
operationId: day_ahead_price_price_get
parameters:
- name: bzn
in: query
required: false
schema:
type: string
default: DE-LU
title: Bzn
- name: start
in: query
required: false
schema:
type: string
default: ''
title: Start
- name: end
in: query
required: false
schema:
type: string
default: ''
title: End
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/PriceModel'
'404':
description: No price data available for that bidding zone/time range
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
type: object
required:
- loc
- msg
- type
title: ValidationError
PriceModel:
properties:
license_info:
type: string
title: License Info
unix_seconds:
anyOf:
- items:
type: integer
type: array
- type: 'null'
title: Unix Seconds
price:
anyOf:
- items:
anyOf:
- type: number
- type: 'null'
type: array
- type: 'null'
title: Price
unit:
type: string
title: Unit
deprecated:
type: boolean
title: Deprecated
type: object
required:
- license_info
- unit
- deprecated
title: PriceModel
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError