get_stromkonto_balances
Retrieves Stromkonto (energy account) balance information including GrünstromBonus tracking and CORI token balances. Returns balances across different categories (green power bonus, self-generation, CO2, etc.) with transaction history.
submit_meter_reading
Submits an electricity meter reading and receives a decorated response with CO2 emissions breakdown. The reading is split into green and grey energy components based on the GrünstromIndex. Useful for ESG Scope 2 emissions reporting and real-time CO2 tracking.
calculate_co2_offset
Calculates CO2 offset needs and compensation options for a given amount of CO2 emissions. Determines how many trees or other offsets are needed to compensate for the specified emissions amount. Useful for sustainability reporting and carbon neutrality planning.
get_tariff_info
Provides a breakdown of energy tariff cost components for a German postal code. Shows different cost elements that make up the electricity price, useful for understanding the composition of energy costs and identifying savings opportunities.
get_dispatch
Provides insights into the flow and composition of renewable energy for a German city. Returns energy mix breakdowns (solar, wind, biomass, etc.), energy flow origins and destinations between locations, and geospatial coordinates for visualization.
get_strommix
Provides data on Germany's electricity generation mix across renewable and non-renewable sources. Includes breakdowns by source type (biomass, solar, wind onshore/offshore, nuclear, fossil fuels, etc.) for a given time period. Useful for analyzing energy production trends and renewable energy adoption.
get_green_power_index
Retrieves the GrünstromIndex (Green Power Index) forecast for a German postal code. Returns hourly predictions of renewable energy availability, CO2 emissions per kWh, and dynamic energy pricing. Useful for optimizing energy consumption around periods of high renewable energy availability.
get_best_hour
Finds the best hour to consume energy based on renewable energy availability and low CO2 emissions for a given German location. Returns whether a device should be turned on now, based on the greenest hours within the specified timeframe.
get_merit_order
Retrieves German electricity merit-order analysis grouped into price buckets, including generation capacity utilization and actual generation by source.
get_solar_prediction
Provides solar energy production forecasts for a specific location and panel configuration. Returns hourly energy estimates in watt-hours. Supports customization based on panel technology, tilt angle, azimuth, and installed capacity.
get_market_data
Retrieves real-time and forecasted electricity pricing data for a German location. Returns time-stamped pricing intervals with market-level prices in EUR/MWh, compatible with the awattar API format. Useful for cost optimization and energy trading decisions.
create_energy_schedule
Creates an optimized device-operation schedule for a German location using price, solar, emission, or comfort optimization. Returns time slots and a schedule ID for subsequent retrieval and updates.
update_co2_meter
Creates a CO2 meter for a German postal code or updates an existing meter using its meterId. Submit the cumulative electricity reading in whole watt-hours and retain the returned meterId.
report_energy_schedule_consumption
Reports measured energy or power and completed time slots for an existing schedule. Use the schedule ID returned by create_energy_schedule.
compare_charge_or_fuel
Compares electricity and fuel costs and CO2 emissions per 100 km for a plug-in hybrid in Germany. Returns local fuel station details and price-based and emission-based advice.
get_co2_advice
Retrieves hourly CO2 intensity and traffic-light advice for electricity consumption at a German postal code, including threshold definitions and location information.
get_energy_schedule
Retrieves an energy schedule, current device recommendation, time slots, and progress. Use the schedule ID returned by create_energy_schedule.
get_co2_meter
Retrieves a CO2 meter and its latest reading, emissions, forecast, and expiry. Use the meterId returned by update_co2_meter.
update_energy_schedule_requirements
Updates the optimization requirements of an existing energy schedule. Use the schedule ID returned by create_energy_schedule.