Fetch today's hourly day-ahead electricity spot prices for a Nordic bidding zone.
Use this for current and near-term (today/tomorrow) price queries. Do not use
for historical price analysis — use search_filings with report_type='macro_summary'
and a date reference in the query for that purpose.
Tomorrow's prices are published by NordPool around 13:00 CET; requests before
that time will return "not yet available" for the tomorrow field.
All zones return prices in EUR/kWh (NordPool day-ahead, native currency).
Norwegian zones (NO1–NO5) use hvakosterstrommen.no; all other zones use ENTSO-E.
Args:
zone: Bidding zone code. Options:
NO1 (East/Oslo), NO2 (Southwest), NO3 (Central/Trondheim),
NO4 (North), NO5 (West/Bergen),
SE1–SE4, DK1, DK2, FI.
include_tomorrow: Set to True to also fetch tomorrow's hourly prices if
already published (default False).
Returns:
Dict containing zone, date, current_hour_utc, current price, and a 'today'
summary with min/max/avg and the full hourly list. Includes a 'tomorrow'
key if include_tomorrow=True. Returns {'error': '<message>'} if price data
is unavailable for the requested zone or date.