API documentation:

Daily Macrozonal Imbalance

This endpoint replaces its counterpart in the Market And Fees section: market-and-fees/v1.0/daily-macrozonal-imbalance.

https://api.terna.it/fees/v1.0/daily-macrozonal-imbalance?dateFrom=10/05/2022&dateTo=21/05/2022&dataType=Orario

It contains details of the final macrozonal imbalance signs calculated daily with reference to the previous day as defined in Article 39.1 of Del. 111/06. The section contains hourly and quarterly data; the former are used for the purpose of calculating imbalances for consumption and production units not enabled to the Dispatching Services Market while the latter are used only for production units enabled to the Dispatching Services Market.

The data coincide with those already available in the Sunset of MyTerna, where they can be downloaded manually. Data are updated every 5 minutes with a delta of up to 1 minute from the MyTerna portal.

Authorization OAuth 2.0

Request Header

API field	Type	Description	Format	Card	Example
Authorization	String	Authorization token obtained through Client Id and Client Secret.		1..1	<your access token>
businessID	String	Optional identifier that can be used to identify the message during the analysis phase when opening a ticket to Terna's support team.		0..1	b57aca2f-41b8-4a6e-a43c-2fc5f8309f94
Accept	String	The "Accept" header tells the server what type of content is preferred in the response.		0..1	Application/Json

Query Params

API field	Type	Description	Format	Card	Example
dateFrom	String	Starting date of extraction	dd/mm/yyyy	1..1	15/2/2021
dateTo	String	Final date of extraction	dd/mm/yyyy	1..1	15/2/2021
dataType	String	Type of data to be extracted. If not entered, the filter is not applied and all types will be considered in the search	restricted list	0..1	Orario

Type List

Type is to be chosen as an element of the set ['Orario','Quarto Orario']

Response Structure

API field	Type	Description	Format	Card	Example
result	Obj	Request result		1..1	"result":{..}
.message	String	Specify the status and if successful, report the request		1..1	"message": "Operation completed for the following input: date from: 20/05/2022, date to: 23/05/2022",
.status	String	Specify the status and if successful, report the request		1..1	"status": "Completed"
daily_macrozonal_imbalance	Obj	Daily Macrozonal Imbalance Structure	array	0..n
.publication_date	String	Date	yyyy-mm-dd hh:mm:ss	1..1	2022-10-01 00:00:00
.reference_date	String	Date	yyyy-mm-dd hh:mm:ss	1..1	2022-09-01 00:00:00
.data_type	String	Data type		0..1	Orario
.date_tz	String	Time Zone		1..1	Europe/Rome
.macrozone	String	Macrozone		0..1	NORD
.zonal_aggregate_unbalance_MWh	String	tbd		0..1	-56
.zonal_aggregate_sign	String	tbd		1..1	-
exchanges_MWh	String	tbd		0..1	-55
.foreign_MWh	String	tbd		0..1	1081

Example

cURL Request

curl -X 'GET' 'https://api.terna.it/ifees/v1.0/market/daily-macrozonal-imbalance?dateFrom=10/05/2022&dateTo=21/05/2022&dataType=Orario' --header 'Authorization: <token>'

Response

{
        "result": {
            "message": "Operation completed for the following input. Date from: 10/05/2022, date to: 21/05/2022, data type: Orario",
            "status": "Completed"
        },
        "daily_macrozonal_imbalance": [
            {
                "publication_date": "2022-05-22 17:00:00",
                "reference_date": "2022-05-21 23:00:00",
                "data_type": "Orario",
                "date_tz": "Europe/Rome",
                "macrozone": "SUD",
                "zonal_aggregate_unbalance_MWh": "476.51",
                "zonal_aggregate_sign": "+",
                "exchanges_MWh": "1799.602",
                "foreign_MWh": "-186.422"
            },
            {
                "publication_date": "2022-05-22 17:00:00",
                "reference_date": "2022-05-21 23:00:00",
                "data_type": "Orario",
                "date_tz": "Europe/Rome",
                "macrozone": "NORD",
                "zonal_aggregate_unbalance_MWh": "142.061",
                "zonal_aggregate_sign": "+",
                "exchanges_MWh": "-1799.602",
                "foreign_MWh": "5571.152"
            }
            ]
}

Cookie