• Register

Scheduled Foreign Exchange

Differenze rispetto alla versione 1.0

  • L'endpoint da richiamare è stato modificato.
  • Aggiunto campo Offset nel risultato.
  • Aggiunto campo Timezone nel risultato.
https://api.terna.it/transmission/v2.0/scheduled-foreign-exchange?dateFrom=10/10/2021&dateTo=10/11/2021
Allows to obtain data representing scheduled trade exchanges between Italy, neighbouring TSOs, Corsica and Malta. Every day, the hourly trade schedule between the market zones is published.

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

I dati sono pubblicati al termine dei processi di allocazione di capacità implicita ed esplicita, sono in forma aggregata per tutti gli orizzonti temporali (yearly, monthly, day-ahead, intraday) e tengono conto del mercato di bilanciamento TERRE (Trans European Replacement Reserves Exchange). Qui prendiamo in considerazione il periodo degli ultimi cinque anni, oltre a quello in corso.

Authorization OAuth 2.0

Request Header

API field Type Description Format Card Example
Authorization String Token 1..1   <your access token>
businessID String Business ID 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 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

Response Structure

API field Type Description Format Card Example
result Obj 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: 23/04/2022, date to: 23/04/2022",
.status String Specify the status and if successful, report the request
1..1 "status": "Completed"
scheduled_foreign_exchange Obj Scheduled Foreign Exchange Structure array 0..n
.date String Date yyyy-mm-dd hh:mm:ss 1..1 2020-02-12 23:00:00
.date_tz String Time Zone Continent/City 1..1 Europe/Rome
.date_offset String Time Offset 1..1 +02:00
.country String Country  1..1 Austria
.import String Import  1..1 295
.export String Export  1..1 0
.scheduled_foreign_exchange_MW String Scheduled Foreign Exchange  1..1 295

Example

cURL Request

curl --location --request GET 'https://api.terna.it/transmission/v2.0/scheduled-foreign-exchange?dateFrom=23/04/2022&dateTo=23/04/2022' --header 'Authorization: <token>'

Response

{
            "result": {
                "message": "Operation completed for the following input. Date from: 23/04/2022, date to: 23/04/2022",
                "status": "Completed"
            },
            "scheduled_foreign_exchange": [
                {
                    "date": "2022-04-23 23:00:00",
                    "date_tz": "Europe/Rome",
                    "date_offset": "+02:00",
                    "country": "Slovenia",
                    "import": "0",
                    "export": "0",
                    "scheduled_foreign_exchange_MW": "0"
                },
                {
                    "date": "2022-04-23 23:00:00",
                    "date_tz": "Europe/Rome",
                    "date_offset": "+02:00",
                    "country": "Montenegro",
                    "import": "0",
                    "export": "0",
                    "scheduled_foreign_exchange_MW": "0"
                }
            ]
}