API GME

Client Python per scaricare dal GME i prezzi zonali dell'energia elettrica sul Mercato del Giorno Prima (MGP) con granularita quarto-oraria (PT15), salvare i dati in CSV e generare un grafico tempo vs EUR/MWh.

Funzionalita

• autenticazione alle API GME tramite credenziali nel file .env
• download dell'ultima FlowDate disponibile per una zona di mercato
• estrazione dei 96 quarti d'ora della giornata, salvo anomalie di cambio ora legale/solare
• salvataggio di CSV e grafico PNG nella cartella outputs/
• avvio anche da VS Code tramite Run and Debug

Setup

1. Crea la virtualenv: python3.11 -m venv .venv
2. Attivala: source .venv/bin/activate
3. Installa il progetto: pip install -e .
4. Compila il file .env:

GME_API_USERNAME=il_tuo_nome_utente
GME_API_PASSWORD=la_tua_password

Utilizzo da terminale

Esempio base:

gme-mgp-zonal-prices --zone NORD

Oppure senza script installato:

.venv/bin/python srcs/programs/gme_mgp_zonal_prices.py --zone NORD

Opzioni utili:

gme-mgp-zonal-prices --zone CSUD --lookback-days 14 --lookahead-days 2 --output-dir outputs

Output

Per ogni esecuzione vengono creati:

• outputs/gme_mgp_prices_<ZONE>_<FLOWDATE>.csv
• outputs/gme_mgp_prices_<ZONE>_<FLOWDATE>.png

Esempio:

• outputs/gme_mgp_prices_NORD_20260323.csv
• outputs/gme_mgp_prices_NORD_20260323.png

Utilizzo da VS Code

Nel pannello Run and Debug seleziona la configurazione GME MGP Zonal Prices, poi scegli la zona dal menu proposto.

Prima di lanciarla, assicurati che l'interprete selezionato in VS Code sia .venv/bin/python.

Struttura progetto

• srcs/programs/gme_mgp_zonal_prices.py: client CLI per autenticazione, download, normalizzazione e grafico
• srcs/tests/test_gme_mgp_zonal_prices.py: test unitari del parsing e della trasformazione dati
• .vscode/launch.json: configurazione Run/Debug con scelta zona
• 20251015Manuale_Utente_API.pdf: manuale utente GME
• 20251015Manuale_tecnico_API.pdf: guida tecnica API GME

Test

.venv/bin/python -m unittest discover -s srcs/tests -p "test_*.py"