{"openapi":"3.1.0","info":{"title":"Energy Index API","version":"1.0.0","description":"Prezzi all'ingrosso dell'energia in Italia (PUN, PSV, prezzi zonali), indici di contesto (TTF, Brent, CO2), Energy Index delle offerte ARERA e forecast EIDX Research. Endpoint Open gratuiti senza chiave, con attribuzione obbligatoria.","contact":{"name":"Energy Index","email":"pro@energyindex.pro","url":"https://energyindex.it/it/api"},"license":{"name":"Gratuita con attribuzione (piani Open e Developer)","url":"https://energyindex.it/it/api/docs#licenza"}},"externalDocs":{"description":"Documentazione completa","url":"https://energyindex.it/it/api/docs"},"servers":[{"url":"https://energyindex.it/api/v1"}],"tags":[{"name":"Prezzi di mercato","description":"PUN nazionale e zonale, PSV, TTF, Brent, CO2: valori del giorno e serie storiche."},{"name":"Energy Index e mercato libero","description":"Gli indici proprietari costruiti sulle offerte del Portale Offerte ARERA."},{"name":"Forecast","description":"Previsioni EIDX Research con bande di confidenza e track record verificabile."},{"name":"Tool di calcolo","description":"I calcolatori di Energy Index ed EIDX Pro esposti come servizio."},{"name":"Trading e risk","description":"Indicatori quantitativi per desk di trading e risk management."},{"name":"Alert ed export","description":"Webhook su soglie di prezzo ed export massivi."}],"security":[{"bearerAuth":[]}],"paths":{"/today":{"get":{"operationId":"today","summary":"Snapshot di tutti gli indici","description":"Restituisce l'ultimo valore disponibile di ogni indice. Pensato per dashboard e widget che mostrano una fotografia del mercato senza fare cinque richieste. Gli indici senza dato disponibile vengono omessi, non restituiti come null.\n\nPiano minimo: Open.","tags":["Prezzi di mercato"],"x-status":"live","x-eidx-tier":"open","externalDocs":{"url":"https://energyindex.it/it/api/docs#today"},"parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"date":"2026-09-26","values":{"PUN":{"date":"2026-09-26","value":0.11873,"unit":"€/kWh","value_native":118.73,"unit_native":"€/MWh","asset":"PUN","source":"GME"},"PSV":{"date":"2026-09-26","value":0.03902,"unit":"€/kWh","value_native":39.02,"unit_native":"€/MWh","asset":"PSV","source":"GME"},"TTF":{"date":"2026-09-26","value":0.03511,"unit":"€/kWh","value_native":35.11,"unit_native":"€/MWh","asset":"TTF","source":"ICE Endex"},"Brent":{"date":"2026-09-26","value":71.42,"unit":"$/bbl","asset":"Brent","source":"EIA"},"CO2":{"date":"2026-09-26","value":68.9,"unit":"€/tCO2","asset":"CO2","source":"EEX"}},"attribution":"Energy Index — https://energyindex.it (gratis, attribuzione richiesta)","source_page":"https://energyindex.it/it","docs":"https://energyindex.it/api/v1"}}}},"400":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"security":[]}},"/pun/today":{"get":{"operationId":"punToday","summary":"PUN di oggi","description":"Ultimo PUN pubblicato dal GME dopo la chiusura del Mercato del Giorno Prima, di norma entro il primo pomeriggio. Il valore e' fornito sia in €/kWh, comodo per ragionare in bolletta, sia nell'unita' nativa €/MWh.\n\nPiano minimo: Open.","tags":["Prezzi di mercato"],"x-status":"live","x-eidx-tier":"open","externalDocs":{"url":"https://energyindex.it/it/api/docs#pun-today"},"parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"date":"2026-09-26","observed_at":"2026-09-26T10:30:00.000Z","value":0.11873,"unit":"€/kWh","value_native":118.73,"unit_native":"€/MWh","asset":"PUN","asset_name":"Prezzo Unico Nazionale energia elettrica Italia","source":"GME","source_url":"https://www.mercatoelettrico.org","attribution":"Energy Index — https://energyindex.it (gratis, attribuzione richiesta)","page":"https://energyindex.it/it/indice/pun"}}}},"400":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"security":[]}},"/psv/today":{"get":{"operationId":"psvToday","summary":"PSV di oggi","description":"Ultimo PSV giornaliero pubblicato dal GME, in €/kWh e nell'unita' nativa €/MWh. Riferimento delle offerte gas a prezzo variabile.\n\nPiano minimo: Open.","tags":["Prezzi di mercato"],"x-status":"live","x-eidx-tier":"open","externalDocs":{"url":"https://energyindex.it/it/api/docs#psv-today"},"parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"date":"2026-09-26","observed_at":"2026-09-26T16:00:00.000Z","value":0.03902,"unit":"€/kWh","value_native":39.02,"unit_native":"€/MWh","asset":"PSV","asset_name":"Punto di Scambio Virtuale gas naturale Italia","source":"GME","source_url":"https://www.mercatoelettrico.org","attribution":"Energy Index — https://energyindex.it (gratis, attribuzione richiesta)","page":"https://energyindex.it/it/indice/psv"}}}},"400":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"security":[]}},"/ttf/today":{"get":{"operationId":"assetTodayTtf","summary":"TTF, Brent e CO2 di oggi","description":"Estende il pattern /{asset}/today agli indici di contesto: TTF (gas europeo), Brent (petrolio) e CO2 (quote EU ETS). Oggi questi valori sono gia' disponibili dentro /today.\n\nPiano minimo: Open. In arrivo: contratto in anteprima, l'endpoint non risponde ancora.","tags":["Prezzi di mercato"],"x-status":"coming","x-eidx-tier":"open","externalDocs":{"url":"https://energyindex.it/it/api/docs#asset-today"},"parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"date":"2026-09-26","observed_at":"2026-09-26T17:30:00.000Z","value":0.03511,"unit":"€/kWh","value_native":35.11,"unit_native":"€/MWh","asset":"TTF","asset_name":"Title Transfer Facility gas Europa","source":"ICE Endex","source_url":"https://www.theice.com","attribution":"Energy Index — https://energyindex.it (gratis, attribuzione richiesta)","page":"https://energyindex.it/it/indice/ttf"}}}},"400":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"security":[]}},"/brent/today":{"get":{"operationId":"assetTodayBrent","summary":"TTF, Brent e CO2 di oggi","description":"Estende il pattern /{asset}/today agli indici di contesto: TTF (gas europeo), Brent (petrolio) e CO2 (quote EU ETS). Oggi questi valori sono gia' disponibili dentro /today.\n\nPiano minimo: Open. In arrivo: contratto in anteprima, l'endpoint non risponde ancora.","tags":["Prezzi di mercato"],"x-status":"coming","x-eidx-tier":"open","externalDocs":{"url":"https://energyindex.it/it/api/docs#asset-today"},"parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"date":"2026-09-26","observed_at":"2026-09-26T17:30:00.000Z","value":0.03511,"unit":"€/kWh","value_native":35.11,"unit_native":"€/MWh","asset":"TTF","asset_name":"Title Transfer Facility gas Europa","source":"ICE Endex","source_url":"https://www.theice.com","attribution":"Energy Index — https://energyindex.it (gratis, attribuzione richiesta)","page":"https://energyindex.it/it/indice/ttf"}}}},"400":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"security":[]}},"/co2/today":{"get":{"operationId":"assetTodayCo2","summary":"TTF, Brent e CO2 di oggi","description":"Estende il pattern /{asset}/today agli indici di contesto: TTF (gas europeo), Brent (petrolio) e CO2 (quote EU ETS). Oggi questi valori sono gia' disponibili dentro /today.\n\nPiano minimo: Open. In arrivo: contratto in anteprima, l'endpoint non risponde ancora.","tags":["Prezzi di mercato"],"x-status":"coming","x-eidx-tier":"open","externalDocs":{"url":"https://energyindex.it/it/api/docs#asset-today"},"parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"date":"2026-09-26","observed_at":"2026-09-26T17:30:00.000Z","value":0.03511,"unit":"€/kWh","value_native":35.11,"unit_native":"€/MWh","asset":"TTF","asset_name":"Title Transfer Facility gas Europa","source":"ICE Endex","source_url":"https://www.theice.com","attribution":"Energy Index — https://energyindex.it (gratis, attribuzione richiesta)","page":"https://energyindex.it/it/indice/ttf"}}}},"400":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"security":[]}},"/prices/{asset}/series":{"get":{"operationId":"pricesSeries","summary":"Serie storica giornaliera","description":"Serie giornaliera di un indice tra due date. La profondita' storica dipende dal piano. Con format=csv la risposta e' un file CSV con separatore ';' e decimali con la virgola, pronto per Excel in italiano e per IMPORTDATA di Google Sheets.\n\nPiano minimo: Open. In arrivo: contratto in anteprima, l'endpoint non risponde ancora.","tags":["Prezzi di mercato"],"x-status":"coming","x-eidx-tier":"open","externalDocs":{"url":"https://energyindex.it/it/api/docs#prices-series"},"parameters":[{"name":"asset","in":"path","required":true,"description":"Indice richiesto.","schema":{"type":"string","enum":["pun","psv","ttf","brent","co2"],"example":"pun"}},{"name":"from","in":"query","required":false,"description":"Data iniziale inclusa (YYYY-MM-DD). Default: 30 giorni fa.","schema":{"type":"string","example":"2026-09-01"}},{"name":"to","in":"query","required":false,"description":"Data finale inclusa (YYYY-MM-DD). Default: oggi.","schema":{"type":"string","example":"2026-09-26"}},{"name":"unit","in":"query","required":false,"description":"Unita' dei valori.","schema":{"type":"string","enum":["kwh","mwh"],"default":"mwh"}},{"name":"format","in":"query","required":false,"description":"Formato della risposta.","schema":{"type":"string","enum":["json","csv"],"default":"json"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"asset":"PUN","unit":"€/MWh","from":"2026-09-20","to":"2026-09-26","count":7,"points":[{"date":"2026-09-20","value":112.4},{"date":"2026-09-21","value":104.87},{"date":"2026-09-22","value":121.06},{"date":"2026-09-23","value":124.31},{"date":"2026-09-24","value":119.52},{"date":"2026-09-25","value":116.9},{"date":"2026-09-26","value":118.73}],"stats":{"min":104.87,"max":124.31,"avg":116.98},"attribution":"Energy Index — https://energyindex.it (gratis, attribuzione richiesta)"}},"text/csv":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"security":[]}},"/pun/zones":{"get":{"operationId":"punZones","summary":"PUN per zona di mercato","description":"Prezzi zonali del Mercato del Giorno Prima per Nord, Centro-Nord, Centro-Sud, Sud, Sicilia e Sardegna, piu' il PUN nazionale, con lo spread di ogni zona rispetto al nazionale.\n\nPiano minimo: Developer. In arrivo: contratto in anteprima, l'endpoint non risponde ancora.","tags":["Prezzi di mercato"],"x-status":"coming","x-eidx-tier":"developer","externalDocs":{"url":"https://energyindex.it/it/api/docs#pun-zones"},"parameters":[{"name":"date","in":"query","required":false,"description":"Giorno di mercato (YYYY-MM-DD). Default: ultimo disponibile.","schema":{"type":"string","example":"2026-09-26"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"date":"2026-09-26","unit":"€/MWh","national":118.73,"zones":[{"code":"nord","name":"Nord","value":117.95,"spread_vs_pun":-0.78},{"code":"cnor","name":"Centro-Nord","value":119.4,"spread_vs_pun":0.67},{"code":"csud","name":"Centro-Sud","value":119.88,"spread_vs_pun":1.15},{"code":"sud","name":"Sud","value":116.2,"spread_vs_pun":-2.53},{"code":"sici","name":"Sicilia","value":127.64,"spread_vs_pun":8.91},{"code":"sard","name":"Sardegna","value":119.88,"spread_vs_pun":1.15}],"attribution":"Energy Index — https://energyindex.it (gratis, attribuzione richiesta)"}},"text/csv":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/pun/hourly":{"get":{"operationId":"punHourly","summary":"PUN orario per zona","description":"Prezzi orari del MGP per il PUN nazionale o per una singola zona. E' la base per spostare i consumi nelle ore piu' economiche, calcolare profili F1/F2/F3 o ricostruire il costo di un profilo di carico reale.\n\nPiano minimo: API. In arrivo: contratto in anteprima, l'endpoint non risponde ancora.","tags":["Prezzi di mercato"],"x-status":"coming","x-eidx-tier":"api","externalDocs":{"url":"https://energyindex.it/it/api/docs#pun-hourly"},"parameters":[{"name":"zone","in":"query","required":false,"description":"Zona di mercato.","schema":{"type":"string","enum":["nazionale","nord","cnor","csud","sud","sici","sard"],"default":"nazionale"}},{"name":"date","in":"query","required":false,"description":"Giorno di mercato (YYYY-MM-DD). In alternativa usare from/to (max 31 giorni).","schema":{"type":"string","example":"2026-09-27"}},{"name":"from","in":"query","required":false,"description":"Data iniziale (YYYY-MM-DD).","schema":{"type":"string"}},{"name":"to","in":"query","required":false,"description":"Data finale (YYYY-MM-DD).","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"zone":"nord","date":"2026-09-27","unit":"€/MWh","timezone":"Europe/Rome","hours":[{"hour":1,"starts_at":"2026-09-27T00:00:00+02:00","value":104.1,"band":"F3"},{"hour":2,"starts_at":"2026-09-27T01:00:00+02:00","value":98.62,"band":"F3"},{"hour":14,"starts_at":"2026-09-27T13:00:00+02:00","value":71.3,"band":"F3"},{"hour":20,"starts_at":"2026-09-27T19:00:00+02:00","value":168.45,"band":"F3"}],"cheapest_hours":[13,14,15],"stats":{"min":71.3,"max":168.45,"avg":117.95}}},"text/csv":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/energy-index":{"get":{"operationId":"energyIndex","summary":"Energy Index delle offerte","description":"I quattro indici proprietari Energy Index (Fisse Luce, Variabili Luce, Fisse Gas, Variabili Gas) calcolati sulle offerte pubblicate sul Portale Offerte ARERA. Aggregati di mercato: nessun dato di singolo fornitore.\n\nPiano minimo: Open. In arrivo: contratto in anteprima, l'endpoint non risponde ancora.","tags":["Energy Index e mercato libero"],"x-status":"coming","x-eidx-tier":"open","externalDocs":{"url":"https://energyindex.it/it/api/docs#energy-index"},"parameters":[{"name":"commodity","in":"query","required":false,"description":"Filtra per commodity.","schema":{"type":"string","enum":["luce","gas"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"updated_at":"2026-09-26","indices":[{"slug":"mercato-libero-luce-fissa","name":"Energy Index · Fisse Luce","unit":"€/kWh","mean":0.1342,"median":0.129,"min":0.0989,"max":0.1995,"offers":212},{"slug":"mercato-libero-luce-variabile","name":"Energy Index · Variabili Luce","unit":"€/kWh","mean":0.1407,"median":0.1376,"min":0.1201,"max":0.1788,"offers":248,"spread_vs_reference":0.0219}],"source":"ARERA — Portale Offerte","attribution":"Energy Index — https://energyindex.it (gratis, attribuzione richiesta)"}}}},"400":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"security":[]}},"/mercato-libero/stats":{"get":{"operationId":"mercatoLiberoStats","summary":"Statistiche mercato libero","description":"Statistiche dettagliate sulle offerte attive del mercato libero: percentili di prezzo, quota fissa mensile, spread applicati sopra PUN/PSV e distribuzione per tipologia di cliente. Base per benchmark di listino e analisi competitive.\n\nPiano minimo: API. In arrivo: contratto in anteprima, l'endpoint non risponde ancora.","tags":["Energy Index e mercato libero"],"x-status":"coming","x-eidx-tier":"api","externalDocs":{"url":"https://energyindex.it/it/api/docs#mercato-libero-stats"},"parameters":[{"name":"commodity","in":"query","required":true,"description":"Commodity.","schema":{"type":"string","enum":["luce","gas"],"example":"luce"}},{"name":"price_type","in":"query","required":false,"description":"Tipologia di prezzo.","schema":{"type":"string","enum":["fisso","variabile"]}},{"name":"customer","in":"query","required":false,"description":"Tipologia di cliente.","schema":{"type":"string","enum":["domestico","business"],"default":"domestico"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"commodity":"luce","price_type":"variabile","offers":248,"spread_eur_kwh":{"p10":0.008,"p25":0.012,"median":0.0165,"p75":0.022,"p90":0.031},"fixed_cost_eur_month":{"p10":6.5,"median":10.9,"p90":16},"updated_at":"2026-09-26"}},"text/csv":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/forecast/{asset}/next":{"get":{"operationId":"forecastNext","summary":"Forecast del giorno dopo","description":"Il valore previsto da EIDX Research per il prossimo giorno di mercato, con l'errore medio del modello negli ultimi 30 giorni per valutarne l'affidabilita'.\n\nPiano minimo: Developer. In arrivo: contratto in anteprima, l'endpoint non risponde ancora.","tags":["Forecast"],"x-status":"coming","x-eidx-tier":"developer","externalDocs":{"url":"https://energyindex.it/it/api/docs#forecast-next"},"parameters":[{"name":"asset","in":"path","required":true,"description":"Indice.","schema":{"type":"string","enum":["pun","psv","ttf"],"example":"pun"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"asset":"PUN","target_date":"2026-09-28","value":114.6,"unit":"€/MWh","model":"eidx-ensemble-v3","mape_30d":0.071,"generated_at":"2026-09-27T06:00:00Z","methodology":"https://energyindex.it/it/forecast/metodologia"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/forecast/{asset}":{"get":{"operationId":"forecast","summary":"Forecast con bande di confidenza","description":"La curva di previsione completa, un punto al giorno, con banda di confidenza P10–P90. Stesso modello del forecast pubblico, con storico delle previsioni passate verificabile via /forecast/track-record.\n\nPiano minimo: API. In arrivo: contratto in anteprima, l'endpoint non risponde ancora.","tags":["Forecast"],"x-status":"coming","x-eidx-tier":"api","externalDocs":{"url":"https://energyindex.it/it/api/docs#forecast"},"parameters":[{"name":"asset","in":"path","required":true,"description":"Indice.","schema":{"type":"string","enum":["pun","psv","ttf"],"example":"pun"}},{"name":"horizon","in":"query","required":false,"description":"Orizzonte in giorni.","schema":{"type":"integer","enum":[7,30,90,180],"default":30}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"asset":"PUN","unit":"€/MWh","horizon_days":30,"generated_at":"2026-09-27T06:00:00Z","points":[{"date":"2026-09-28","p10":104.2,"p50":114.6,"p90":126.1},{"date":"2026-09-29","p10":105.8,"p50":117.2,"p90":130.4},{"date":"2026-10-27","p10":98.4,"p50":121.9,"p90":149.7}],"summary":{"avg_p50":119.3,"trend":"up"}}},"text/csv":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/forecast/{asset}/scenarios":{"get":{"operationId":"forecastScenarios","summary":"Forecast 12 mesi a scenari","description":"Proiezione mensile a 12 mesi in tre scenari, con le ipotesi su gas, CO2 e domanda che li guidano. E' la base del modulo Forecast Scenari di EIDX Pro.\n\nPiano minimo: Pro. In arrivo: contratto in anteprima, l'endpoint non risponde ancora.","tags":["Forecast"],"x-status":"coming","x-eidx-tier":"pro","externalDocs":{"url":"https://energyindex.it/it/api/docs#forecast-scenarios"},"parameters":[{"name":"asset","in":"path","required":true,"description":"Indice.","schema":{"type":"string","enum":["pun","psv"],"example":"pun"}},{"name":"months","in":"query","required":false,"description":"Numero di mesi (1–12, 24 per Enterprise).","schema":{"type":"integer","default":12}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"asset":"PUN","unit":"€/MWh","months":[{"month":"2026-10","base":118.4,"bull":134.9,"bear":101.2},{"month":"2026-11","base":124.7,"bull":146.3,"bear":104.8}],"assumptions":{"ttf_base":35.5,"co2_base":70.2}}},"text/csv":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/tools/bill-estimate":{"get":{"operationId":"billEstimate","summary":"Stima spesa bolletta","description":"Stima la spesa annua e mensile per la sola materia energia su un consumo dato, con PUN o PSV attuale piu' lo spread medio del mercato libero. Utile per blog, siti di consumatori e calcolatori embeddati. Non include oneri di sistema, trasporto e imposte, che vengono indicati a parte come ordine di grandezza.\n\nPiano minimo: Open. In arrivo: contratto in anteprima, l'endpoint non risponde ancora.","tags":["Tool di calcolo"],"x-status":"coming","x-eidx-tier":"open","externalDocs":{"url":"https://energyindex.it/it/api/docs#bill-estimate"},"parameters":[{"name":"commodity","in":"query","required":true,"description":"Commodity.","schema":{"type":"string","enum":["luce","gas"],"example":"luce"}},{"name":"consumption","in":"query","required":true,"description":"Consumo annuo in kWh (luce) o Smc (gas).","schema":{"type":"number","example":2700}},{"name":"price_type","in":"query","required":false,"description":"Offerta a prezzo fisso (Energy Index mediano) o variabile (indice + spread).","schema":{"type":"string","enum":["fisso","variabile"],"default":"variabile"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"commodity":"luce","consumption":2700,"consumption_unit":"kWh/anno","energy_price_eur_kwh":0.13523,"energy_cost_year_eur":365.12,"energy_cost_month_eur":30.43,"basis":"PUN ultimo mese + spread mediano mercato libero","compare_offers":"https://energiapro.biz","attribution":"Energy Index — https://energyindex.it (gratis, attribuzione richiesta)"}}}},"400":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"security":[]}},"/tools/margin-simulator":{"post":{"operationId":"marginSimulator","summary":"Margin Simulator","description":"Simula il margine di un'offerta (spread e quota fissa) su un portafoglio di clienti, con i prezzi forward e gli scenari di stress di EIDX Pro. Stessa logica del modulo Margin Simulator.\n\nPiano minimo: Pro. In arrivo: contratto in anteprima, l'endpoint non risponde ancora.","tags":["Tool di calcolo"],"x-status":"coming","x-eidx-tier":"pro","externalDocs":{"url":"https://energyindex.it/it/api/docs#margin-simulator"},"parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"gross_margin_eur":{"base":162840,"stress_up":128400,"stress_down":171200},"margin_per_customer_eur_year":135.7,"breakeven_spread_eur_kwh":0.0068}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["commodity","spread_eur_kwh","fixed_fee_eur_month","portfolio"],"properties":{"commodity":{"type":"string","enum":["luce","gas"],"description":"luce o gas."},"spread_eur_kwh":{"type":"number","description":"Spread applicato sopra l'indice."},"fixed_fee_eur_month":{"type":"number","description":"Quota fissa mensile."},"portfolio":{"type":"object","description":"Clienti e consumo annuo medio."},"months":{"type":"integer","default":12,"description":"Orizzonte in mesi."}}},"example":{"commodity":"luce","spread_eur_kwh":0.015,"fixed_fee_eur_month":9.9,"portfolio":{"customers":1200,"avg_consumption_kwh":2700},"months":12}}}}}},"/trading/vitals":{"get":{"operationId":"tradingVitals","summary":"Trading Vitals","description":"Gli indicatori del Trading Desk EIDX Pro: spark spread e clean spark spread (PUN vs gas + CO2), volatilita' ATR a 14 giorni, spread PSV–TTF.\n\nPiano minimo: Trading. In arrivo: contratto in anteprima, l'endpoint non risponde ancora.","tags":["Trading e risk"],"x-status":"coming","x-eidx-tier":"trading","externalDocs":{"url":"https://energyindex.it/it/api/docs#trading-vitals"},"parameters":[{"name":"date","in":"query","required":false,"description":"Giorno (YYYY-MM-DD). Default: ultimo.","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"date":"2026-09-26","spark_spread":47.2,"clean_spark_spread":22.1,"psv_ttf_spread":3.91,"atr_14d":{"pun":9.84,"psv":1.72},"unit":"€/MWh"}},"text/csv":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/trading/correlation":{"get":{"operationId":"tradingCorrelation","summary":"Matrice di correlazione","description":"Matrice di correlazione di Pearson sui rendimenti giornalieri, su finestra mobile configurabile.\n\nPiano minimo: Trading. In arrivo: contratto in anteprima, l'endpoint non risponde ancora.","tags":["Trading e risk"],"x-status":"coming","x-eidx-tier":"trading","externalDocs":{"url":"https://energyindex.it/it/api/docs#trading-correlation"},"parameters":[{"name":"window","in":"query","required":false,"description":"Finestra in giorni.","schema":{"type":"integer","enum":[30,90,180],"default":30}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"window_days":30,"assets":["PUN","PSV","TTF"],"matrix":[[1,0.82,0.79],[0.82,1,0.94],[0.79,0.94,1]]}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/trading/backtest":{"post":{"operationId":"tradingBacktest","summary":"Backtest di strategie","description":"Backtest di strategie predefinite (media mobile, soglia, copertura a finestra) su PUN, PSV o TTF, con P&L, drawdown e confronto con buy & hold.\n\nPiano minimo: Trading. In arrivo: contratto in anteprima, l'endpoint non risponde ancora.","tags":["Trading e risk"],"x-status":"coming","x-eidx-tier":"trading","externalDocs":{"url":"https://energyindex.it/it/api/docs#trading-backtest"},"parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"total_return_pct":18.4,"max_drawdown_pct":-7.9,"sharpe":1.21,"trades":37,"benchmark_return_pct":4.2}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["asset","strategy","from","to"],"properties":{"asset":{"type":"string","enum":["pun","psv","ttf"],"description":"Indice."},"strategy":{"type":"string","enum":["sma_cross","threshold","rolling_hedge"],"description":"Strategia."},"from":{"type":"string","description":"Data iniziale del backtest (YYYY-MM-DD)."},"to":{"type":"string","description":"Data finale del backtest (YYYY-MM-DD)."},"params":{"type":"object","description":"Parametri della strategia."}}},"example":{"asset":"pun","strategy":"sma_cross","from":"2024-01-01","to":"2026-09-26","params":{"fast":10,"slow":30}}}}}}},"/alerts":{"post":{"operationId":"alertsCreate","summary":"Crea un alert webhook","description":"Registra un alert: quando l'indice pubblicato attraversa la soglia, Energy Index invia una POST firmata al tuo URL (Slack, Teams, Telegram, Zapier, Make, n8n o il tuo backend). Ogni alert scatta al massimo una volta per giorno di mercato.\n\nPiano minimo: API. In arrivo: contratto in anteprima, l'endpoint non risponde ancora.","tags":["Alert ed export"],"x-status":"coming","x-eidx-tier":"api","externalDocs":{"url":"https://energyindex.it/it/api/docs#alerts-create"},"parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"id":"alr_8Kq2mZ","asset":"psv","condition":"above","threshold":45,"status":"active","signing_secret":"whsec_•••• (mostrato una sola volta)","created_at":"2026-09-27T08:12:44Z"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["asset","condition","threshold","webhook_url"],"properties":{"asset":{"type":"string","enum":["pun","psv","ttf","pun-zona-nord","pun-zona-sud"],"description":"Indice monitorato."},"condition":{"type":"string","enum":["above","below","change_pct"],"description":"Condizione."},"threshold":{"type":"number","description":"Soglia in €/MWh, o variazione % per change_pct."},"webhook_url":{"type":"string","description":"URL HTTPS che ricevera' la notifica."}}},"example":{"asset":"psv","condition":"above","threshold":45,"webhook_url":"https://hooks.slack.com/services/T000/B000/XXXX"}}}}}},"/bulk/{dataset}":{"get":{"operationId":"bulkExport","summary":"Export bulk","description":"Scarica l'intero storico di un dataset in un solo file, rigenerato ogni notte. Per data warehouse, modelli interni e analisi offline.\n\nPiano minimo: Enterprise. In arrivo: contratto in anteprima, l'endpoint non risponde ancora.","tags":["Alert ed export"],"x-status":"coming","x-eidx-tier":"enterprise","externalDocs":{"url":"https://energyindex.it/it/api/docs#bulk-export"},"parameters":[{"name":"dataset","in":"path","required":true,"description":"Dataset.","schema":{"type":"string","enum":["pun-hourly","prices-daily","forecast-history","mercato-libero"],"example":"pun-hourly"}},{"name":"format","in":"query","required":false,"description":"Formato.","schema":{"type":"string","enum":["csv.gz","parquet"],"default":"parquet"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"dataset":"pun-hourly","format":"parquet","rows":1843200,"generated_at":"2026-09-27T02:00:00Z","download_url":"https://energyindex.it/api/v1/bulk/files/pun-hourly-20260927.parquet?sig=…","expires_at":"2026-09-27T03:00:00Z"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"API key eidx_live_… nell'header Authorization."}},"responses":{"Error":{"description":"Errore","content":{"application/json":{"schema":{"type":"object","required":["error","message"],"properties":{"error":{"type":"string","example":"rate_limited"},"message":{"type":"string"},"required_tier":{"type":"string"},"param":{"type":"string"},"docs":{"type":"string"}}}}}}}}}