API

I dati, direttamente dalla piattaforma

Lo stesso livello da cui leggono le pagine del sito. Nessuna chiave, nessuna registrazione, JSON su HTTP. Ogni risposta dice da quale fonte proviene, a quale momento si riferisce e quanto è recente.

Il sistema elettrico, in tempo reale

Domanda, produzione per fonte e scambi transfrontalieri, come li pubblicano i gestori di trasmissione. Aperto.

Indirizzo Che cosa restituisce Frequenza
/api/v1/countries Tutti i paesi della piattaforma, con le loro zone e lo stato di copertura. Cambia di rado — quando cambia il registro.
/api/v1/countries/:iso2/latest L’istantanea di un paese: domanda, produzione per fonte, saldo ai confini. Con la frequenza con cui pubblica il suo gestore — da 10 secondi a un’ora.
/api/v1/countries/:iso2/history Una serie temporale per un paese, su un intervallo scelto. La stessa frequenza dell’istantanea.
/api/v1/europe/latest Il totale europeo e ogni paese che vi entra. Un minuto.
/api/v1/status Lo stato della raccolta: quale fonte ha pubblicato per ultima, e quando. Continua.
/api/v1/licenses Che cosa la piattaforma può fare con i dati di ogni fonte. Quando cambiano le condizioni di una fonte.
/api/v1/search Ricerca tra paesi, zone e termini. Continua.

Il mercato del giorno prima

I prezzi aggiudicati in asta per il giorno successivo, per zona di offerta. Chiuso per ora — il motivo è spiegato più sotto.

Indirizzo Che cosa restituisce Frequenza
/api/v1/prices/latest451 · licenza L’ultimo prezzo noto per ogni zona. Una volta al giorno, dopo l’asta.
/api/v1/prices/zones451 · licenza Le zone di offerta, ciascuna con il proprio fuso orario e la propria valuta. Cambia di rado.
/api/v1/prices/date451 · licenza Tutte le zone, per un giorno di consegna scelto. Giornaliera.
/api/v1/prices/country/:iso2451 · licenza I prezzi di un paese, per ciascuna delle sue zone. Giornaliera.
/api/v1/prices/:zone/history451 · licenza Lo storico di una zona, intervallo per intervallo. Giornaliera.
/api/v1/prices/:zone/summary451 · licenza Media, minimo, massimo e quantili per giorno, settimana o mese. Giornaliera.
/api/v1/market/cheapest451 · licenza Le zone con il prezzo medio più basso del giorno. Giornaliera.
/api/v1/market/expensive451 · licenza Le zone con il prezzo medio più alto del giorno. Giornaliera.
/api/v1/market/spreads451 · licenza La differenza tra l’ora più economica e quella più cara, per zona. Giornaliera.
/api/v1/market/cheapest-window451 · licenza La finestra continua di N ore più economica in una zona. Giornaliera.
/api/v1/market/weekly451 · licenza Il rapporto settimanale, una volta chiusa la settimana. Settimanale.

Perché gli endpoint dei prezzi rispondono con 451

I dati di mercato provengono dalla piattaforma di trasparenza ENTSO-E. Li raccogliamo e li mostriamo sul sito con la fonte scritta accanto a ogni cifra, ma ridistribuirli tramite un’API non è la stessa cosa che mostrarli, e le condizioni di riutilizzo non sono ancora state verificate e registrate da noi.

Fino ad allora, gli endpoint dei prezzi restituiscono 451 — il codice per «non disponibile per motivi legali» — invece di fornire in silenzio qualcosa che non abbiamo il diritto di fornire. Il sistema delle licenze funziona per fonte, non per paese, quindi aprirli non richiede modifiche al codice.

Regole di buon comportamento

Non c’è un limite di richieste, e vorremmo che non ce ne fosse bisogno. Le risposte riportano cache-control: rispettandolo si ottengono esattamente le stesse cifre senza chiedere due volte. I dati in tempo reale non cambiano più spesso di quanto pubblichi il loro gestore — una richiesta al secondo per un paese che pubblica ogni ora non porta nulla di nuovo.

Chi usa i dati pubblicamente è pregato di citare la fonte originale (il gestore di trasmissione o ENTSO-E), non il nostro nome: noi li trasportiamo, non li produciamo.

Vedi anche: Fonti dei dati · Metodologia · Stato del sistema · llms.txt