GET /carbon/factors
Get a comprehensive list of carbon emission factors for common activities including driving, flying (short/medium/long haul), electricity usage, heating, and more. Each factor shows the CO2 equivalent in kilograms per unit of activity. Use this reference data to understand available activities before calling the carbon calculator. Essential for building environmental impact tools and sustainability dashboards.
GET /carbon/calculate
Calculate the CO2 emissions (in kg) for a specific activity and amount. Supports activities like flights, driving, electricity usage, and heating. Provide the activity type and amount (e.g., kilometers driven, kWh consumed). Returns the total CO2 equivalent. Useful for personal carbon footprint trackers, corporate sustainability reporting tools, and environmental awareness apps that help users understand their impact.
GET /carbonintensity/current
Get the current carbon intensity of the UK electricity grid in grams of CO2 per kilowatt-hour (gCO2/kWh), along with the forecast for the next few hours. Lower values mean cleaner electricity. Data from the UK National Grid ESO Carbon Intensity API. Essential for smart home systems that shift energy-intensive tasks to low-carbon periods, EV charging optimizers, and UK energy dashboards.
GET /carbonintensity/generation
Get the current UK electricity generation mix showing the percentage contribution from each energy source: wind, solar, nuclear, gas, coal, hydro, biomass, imports, and others. Provides a real-time snapshot of how the UK's electricity is being produced right now. Useful for energy dashboards, climate education tools, and apps that help users understand when renewable energy percentage is highest.
GET /carbonintensity/date/:date
Get half-hourly carbon intensity data for the UK electricity grid on a specific historical date. Returns 48 half-hour readings showing how carbon intensity varied throughout the day. Useful for analyzing historical patterns, comparing weekday vs weekend energy profiles, and building time-series visualizations of UK grid cleanliness over time. Data from the National Grid ESO.
GET /carbonintensity/postcode/:postcode
Get the regional carbon intensity of the UK electricity grid for a specific postcode area. Different parts of the UK have different energy mixes (e.g., Scotland has more wind, southeast England has more gas). Returns the local carbon intensity and generation mix. Useful for localized energy dashboards, regional sustainability comparisons, and helping UK residents understand their local grid's environmental impact.
GET /stream/topics
List all 14 available streaming topics with descriptions, update frequencies, and supported filters. Each topic can be filtered to specific items (e.g. crypto:bitcoin, electricity:NO1, exchange_rates:EUR/USD). Also shows JavaScript EventSource and curl usage examples.
GET /stream
Connect to a Server-Sent Events stream for real-time push updates. Subscribe to broad topics or filter to specific items using the topic:filter syntax. Events include unique IDs for reconnection (pass Last-Event-ID header to resume). Heartbeat keeps the connection alive. Use curl -N or JavaScript EventSource. 14 topics available: exchange rates, crypto, electricity, commodities, economics, holidays, weather, earthquakes, space weather, NASA, sports, news, VAT, and currencies.
GET /mashup/energy/weather
Analyze the relationship between weather conditions and electricity prices for a specific Nordic bidding zone. Combines real-time electricity spot prices from Nord Pool with current weather data (temperature, wind, cloud cover) to show how weather patterns affect energy costs. Returns price data alongside weather metrics and correlation insights. Essential for energy trading dashboards, smart home optimization, and utility companies analyzing price drivers.
GET /mashup/estonian/power
Combined power grid intelligence: real-time Elektrilevi outages with current electricity price, weather station wind speeds, and storm warnings. Correlates high winds with outage risk.
GET /mashup/green/energy
Nordic green energy assessment: combines current electricity price, generation mix, carbon intensity, weather, and grid demand for any Nord Pool zone.
GET /electricity/zones
List all 9 Nordic electricity bidding zones with their codes, names, and countries. Norway has 5 zones (NO1-NO5) and Sweden has 4 zones (SE1-SE4), each with potentially different electricity prices due to grid capacity and local supply/demand. Use this to discover valid zone codes for the other electricity endpoints. Essential reference data for Nordic energy apps and smart home systems.
GET /electricity/compare
Compare electricity spot prices across all 9 Nordic bidding zones side by side for today or a specified date. Shows the current price in each zone with currency in EUR/MWh and local currency equivalents. Useful for identifying the cheapest and most expensive electricity regions right now, building cross-zone comparison dashboards, and helping businesses with multi-location operations optimize energy purchasing. Data from Nord Pool.
GET /electricity/current/:zone
Get the current hour's electricity spot price for a specific Nordic bidding zone (e.g., NO1 for Oslo area, SE3 for Stockholm area). Returns the price in EUR/MWh along with the current hour period. Essential for smart home automation that adjusts heating, EV charging, or appliance usage based on real-time electricity cost. Also useful for energy cost monitoring dashboards and price alert systems. Data from Nord Pool.
GET /electricity/today/:zone
Get all 24 hourly electricity spot prices for today in a specific Nordic bidding zone. Returns each hour's price in EUR/MWh, making it easy to find the cheapest and most expensive hours of the day. Critical for smart home systems that schedule energy-intensive tasks (laundry, dishwasher, EV charging) during the cheapest hours, and for energy dashboards showing the full daily price curve. Data from Nord Pool.
GET /electricity/stats/:zone
Get daily electricity price statistics for a specific Nordic bidding zone, including the minimum, maximum, and average price for the day, plus the cheapest and most expensive hours. Optionally specify a date for historical stats. Useful for daily energy cost summaries, historical price analysis, and helping consumers understand their electricity cost patterns without processing all 24 hourly data points themselves. Data from Nord Pool.
GET /electricity/history/:zone
Get historical electricity spot prices for a specific Nordic bidding zone over a custom date range. Returns hourly prices for every day in the range. Useful for analyzing long-term electricity price trends, calculating average costs over billing periods, building historical price charts, and performing seasonal analysis of energy costs in Norway and Sweden. Data from Nord Pool.
GET /estonian-utilities
All Estonian utility rates in one response: water (Tallinna Vesi), district heating (Utilitas), electricity network fees (Elektrilevi), natural gas, and waste collection. Includes regulated prices, service providers, and links to official sources. Prices are approved by the Competition Authority (Konkurentsiamet).
GET /estonian-utilities/:type
Get rates for a specific utility type: water, heating, electricity, gas, or waste.
GET /elering/prices
Nord Pool spot electricity prices for Estonia (EE), Finland (FI), Latvia (LV), and Lithuania (LT). Returns hourly prices in EUR/MWh for the specified date range.
GET /elering/prices/today
Today's hourly electricity prices for Estonia, Finland, Latvia, and Lithuania. Convenience endpoint — no date params needed.