Monthly Summary

This endpoint will be substituted20 giugno.can be foundfees/v1.0/monthly-summary.

https://api.terna.it/market-and-fees/v1.0/monthly-summary?dateFrom=10/05/2022&dateTo=21/05/2022&dataType=Orario

Riepilogo mensile segni e prezzi di sbilanciamento

The data coincide with those already available in the Sunset section of MyTerna, where you can download them manually instead.

Authorization OAuth 2.0

Request Header

API field	Type	Description	Format	Card	Example
Authorization	String	Token		1..1	<your access token>
businessID	String	Identificativo facoltativo che può essere utilizzato per identificare il messaggio durante la fase di analisi quando si apre un ticket al support team di Terna.		0..1	b57aca2f-41b8-4a6e-a43c-2fc5f8309f94
Accept	String	Definizione Header Accept		0..1	Application/Json

Query Params

API field	Type	Description	Format	Card	Example
dateFrom	String	Data di inizio dell'estrazione	dd/mm/yyyy	1..1	15/2/2021
dateTo	String	Data di fine dell'estrazione	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	1..1	Orario

Lista Type

Type deve essere scelto come elemento dell'insieme ['Orario','Quarto Orario']

Response Structure

API field	Type	Description	Format	Card	Example
result	Obj	Risultato della richiesta		1..1	"result":{..}
.message	String	Indica lo stato e, in caso di esito positivo, segnala la richiesta.		1..1	"message": "Operation completed for the following request: {YEAR:2023, MONTH:03}",
.status	String	Indica lo stato e, in caso di esito positivo, segnala la richiesta.		1..1	"status": "Completed"
monthly_summary	Obj	Monthly Summary Struttura	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		1..1	Orario
.date_tz	String	Time Zone		1..1	Europe/Rome
.macrozone	String	Macrozone		1..1	NORD
.zonal_aggregate_unbalance_MWh	String	tbd		1..1	-56
.zonal_aggregate_sign	String	tbd		1..1	-
.exchanges_MWh	String	tbd		1..1	-55
.foreign_MWh	String	tbd		1..1	1081
.base_price_EURxMWh	String	tbd		1..1	630
.incentive_component_EURxMWh	String	tbd		1..1	0
.unbalance_price_EURxMWh	String	tbd		1..1	630

Example

cURL Request

curl -X 'GET' 'https://api.terna.it/market-and-fees/v1.0/monthly-summary?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"
        },
        "monthly_summary": [
            {
                "publication_date": "2022-06-01 19:00:00",
                "reference_date": "2022-05-11 03:00:00",
                "data_type": "Orario",
                "date_tz": "Europe/Rome",
                "macrozone": "NORD",
                "zonal_aggregate_unbalance_MWh": "35.17",
                "zonal_aggregate_sign": "+",
                "exchanges_MWh": "-1023.566",
                "foreign_MWh": "6686.317",
                "base_price_EURxMWh": "37.116",
                "incentive_component_EURxMWh": "0",
                "unbalance_price_EURxMWh": "37.116"
            },
            {
                "publication_date": "2022-06-01 19:00:00",
                "reference_date": "2022-05-11 03:00:00",
                "data_type": "Orario",
                "date_tz": "Europe/Rome",
                "macrozone": "SUD",
                "zonal_aggregate_unbalance_MWh": "60.276",
                "zonal_aggregate_sign": "+",
                "exchanges_MWh": "1023.566",
                "foreign_MWh": "596.611",
                "base_price_EURxMWh": "62.839",
                "incentive_component_EURxMWh": "0",
                "unbalance_price_EURxMWh": "62.839"
            }
            ]
}

version 59 as of 3 weeks ago by Andrea Di Cosmo