API documentation:

Preliminary Macrozonal Imbalance

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

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

It contains details of preliminary macrozonal imbalance signs calculated every 15 minutes with a delay of Maximum 30 minutes with respect to the delivery period as defined in Article 39.1bis of Del. 111/06. The section contains hourly data and quarterly data; the former are used for the purpose of forecasting by oerpers of the calculation of imbalances for consumption and production units not enabled to the Dispatch Services Market while the latter for only production units enabled to the Dispatch 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 request: date from: 22/05/2022, date to: 23/06/2022",
.status	String	Specify the status and if successful, report the request		1..1	"status": "Completed"
preliminary_macrozonal_imbalance	Obj	Preliminary 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	Tipo Dato		1..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/preliminary-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"
        },
        "preliminary_macrozonal_imbalance": [
            {
                "publication_date": "2022-05-22 00:38:00",
                "reference_date": "2022-05-21 23:00:00",
                "data_type": "Orario",
                "date_tz": "Europe/Rome",
                "macrozone": "SUD",
                "zonal_aggregate_unbalance_MWh": "466.121",
                "zonal_aggregate_sign": "+",
                "exchanges_MWh": "1808.426",
                "foreign_MWh": "-184.856"
            },
            {
                "publication_date": "2022-05-22 00:38:00",
                "reference_date": "2022-05-21 23:00:00",
                "data_type": "Orario",
                "date_tz": "Europe/Rome",
                "macrozone": "NORD",
                "zonal_aggregate_unbalance_MWh": "135.393",
                "zonal_aggregate_sign": "+",
                "exchanges_MWh": "-1808.426",
                "foreign_MWh": "5592.644"
            }
        ]
}

Cookie