# Energy Portugal

Energy Portugal compares currently valid fixed-price Portuguese electricity offers from versioned ERSE datasets.

Canonical site: https://energy.diasmorais.com/
OpenAPI: https://energy.diasmorais.com/openapi.json
REST documentation: https://energy.diasmorais.com/docs
MCP Streamable HTTP: https://energy.diasmorais.com/mcp
Dataset status: https://energy.diasmorais.com/v1/status

GET comparison examples:
https://energy.diasmorais.com/compare?annual_kwh=5000&power_kva=6.9&tariff=simple&top=5
https://energy.diasmorais.com/compare?peak_kwh=3000&off_peak_kwh=4000&power_kva=6.9&tariff=bi&top=5
https://energy.diasmorais.com/v1/electricity/compare?peak_kwh=43&off_peak_kwh=170&days=31&power_kva=6.9&tariff=bi&top=10

GET /compare query parameters:
- power_kva: required contracted BTN power
- tariff: simple, bi, tri, or best; defaults to simple
- annual_kwh: aggregate annual consumption for simple/best
- kwh and days: observed-period alternative for simple
- peak_kwh and off_peak_kwh: bi-hourly consumption; annual unless days is supplied
- peak_kwh, shoulder_kwh, and off_peak_kwh: tri-hourly consumption; annual unless days is supplied
- customer: domestic or business; defaults to domestic
- group_by: supplier or offer; defaults to supplier
- top: 1 to 50; defaults to 5
- supply: any, electricity (excludes gas bundles), or dual; defaults to any

The response includes ERSE dataset provenance. annual_supply_cost_eur is a supply-only estimate; estimated_annual_bill_eur is null until taxes and common regulated charges can be reproduced reliably.