Skip to main content
Corrently logo
  • Category: analytics
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 23
  • Triggers: 0
  • Slug: CORRENTLY
  • Version: 20261101_00

Tools

Slug: CORRENTLY_CO2_METER_UPDATE_READINGTool to create or update a CO₂ meter reading for emissions tracking. Use when sending new or updated electricity consumption readings to Corrently.

Input Parameters

string
required
German 5-digit postal code indicating the meter’s location.
integer
Unix timestamp of the reading in seconds since epoch. Defaults to current server time if omitted.
number
required
New meter reading value (in watt-hours).
string
required
Unique identifier for the CO₂ meter.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CORRENTLY_COMMIT_QUITTUNGTool to finalize a Strom-Quittung (electricity receipt) after collecting transaction data. Use after gathering seller, buyer, and transaction details to create the final receipt.

Input Parameters

string
Quittung session account identifier. Optional identifier for linking the receipt to a session.
number
required
Amount of energy transferred in the transaction in kWh.
string
required
Unique identifier for the transaction associated with this receipt.
string
required
Name of the buyer (energy consumer receiving the receipt).
string
required
Name of the seller (energy provider or entity issuing the receipt).
number
required
Duration of the transaction in seconds.
string
required
Email address of the seller for contact and receipt delivery.
string
required
Five-digit German postal code of the seller’s location.
number
required
Yearly energy consumption of the seller in kWh.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CORRENTLY_GEOCODE_LOCATIONTool to geocode a free-text location into coordinates. Use when you need latitude and longitude from a place name.

Input Parameters

string
required
Free-form location string (e.g., city, address, landmark).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CORRENTLY_GET_ENERGY_SCHEDULECreate an optimized operation schedule for energy-consuming devices based on the GrünstromIndex (Green Power Index). This tool determines the best time slots to run energy-intensive devices (heat pumps, EV chargers, etc.) by analyzing regional renewable energy availability, electricity prices, and CO2 emissions forecasts. Use this after collecting: - German postal code (required for regional data) - Desired optimization goal (price, co2, or comfort) - Number of hours the device needs to run

Input Parameters

string
required
German 5-digit postal code (Postleitzahl) for location-specific green energy scheduling. Example: ‘69168’.
object
required
Device energy usage requirements and optimization preferences.
integer
Planning horizon in hours. Defaults to 24 hours (one day). Maximum typically 168 hours (one week).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CORRENTLY_GET_METERING_READINGTool to retrieve metered electricity reading with green/grey energy split and CO2 emissions data. Use when you need to check current meter readings or analyze energy consumption patterns for a Stromkonto.

Input Parameters

string
required
Account/Address (Stromkonto) to retrieve reading for. Must be a valid Ethereum address format.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CORRENTLY_GET_STROMKONTO_BALANCESRetrieve Stromkonto account balances from the energy blockchain ledger. Stromkonto is a ledger for green energy related transactions backed by Energychain blockchain to provide consensus of balances and transactions. Returns balance details across multiple sub-account types (green power bonus, generation, self-consumption, carbon offset, trees planted).

Input Parameters

string
Ethereum style address referencing a valid account (AKA Stromkonto). If not provided, returns balances for all accounts or default account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CORRENTLY_GET_STROMKONTO_CHOICESTool to get selectable contract choices for a Stromkonto customer. Use when you need to retrieve available balance and transaction options for an account.

Input Parameters

string
required
Ethereum-style address referencing a valid Stromkonto account (e.g., 0x0000000000000000000000000000000000000000). This parameter is required to avoid 502 errors.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CORRENTLY_GET_WIM_PROCESS_STATUSRetrieve status information for WiM (Wechselprozesse im Messwesen) metering change processes. WiM processes handle meter changes and allocation workflows in the German electricity system. Use this tool to check the current status of ongoing or completed metering change processes, track process progress, or verify when a WiM process was initiated.

Input Parameters

string
VID (Vorgangsidentifikation) key of the metering change process to query. If not provided, returns status for all processes accessible with the current authentication.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CORRENTLY_GRUNSTROM_INDEX_FORECASTTool to retrieve hourly green power forecast and CO2 data. Use after obtaining the user API key.

Input Parameters

string
required
User/account identifier provided for API access.
string
required
Five-digit German postal code of the location to query.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CORRENTLY_GSI_BEST_HOURDetermines if now is the best time to turn on a device based on regional green energy (GrünstromIndex) forecasts in Germany. Returns true if the current hour has high renewable energy availability within the specified timeframe, false if waiting would be more sustainable.

Input Parameters

string
Stromkonto account address or API key for personalized forecasts.
string
required
German 5-digit postal code (PLZ) for location-based green energy forecast. Required.
integer
Number of consecutive hours the device needs to run.
integer
Number of hours ahead to scan for the best green-energy window (default 24).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CORRENTLY_LOGIN_STROMKONTOTool to initiate login to Stromkonto via email. Use when authenticating a user with their email address.

Input Parameters

string
required
Email address for login to Stromkonto account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CORRENTLY_MARKET_DATARetrieve real-time and forecast electricity pricing data for Germany by postal code (Postleitzahl). Returns wholesale market prices (EUR/MWh) and localized prices for specific grid areas. Data is provided in time intervals with timestamps in milliseconds since Unix epoch. Use this tool when you need current or forecasted electricity prices for energy optimization, cost analysis, or smart grid applications in Germany.

Input Parameters

string
required
Five-digit German postal code (Postleitzahl) for electricity market data lookup. Example: ‘69168’ for Wiesloch, ‘80331’ for Munich, ‘10115’ for Berlin.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CORRENTLY_PHEV_NAVIGATORGet price-based and emissions-based PHEV charge-or-fuel recommendations for a German postal code, with available fuel and electricity data. Missing recommendation fields default to charge.

Input Parameters

string
Optional Stromkonto account address or API key for authenticated access with higher rate limits.
integer
Battery state of charge as percentage (0-100). Optional but recommended for accurate cost calculations.
string
required
German 5-digit postal code (PLZ) for the location. This is required to determine local fuel prices and electricity rates.
number
Vehicle fuel consumption in liters per 100 km. Used to calculate fuel costs per 100 km.
number
Vehicle electric power consumption in kWh per 100 km. Used to calculate electricity costs per 100 km.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CORRENTLY_POST_METERING_READINGPost an electricity meter reading for green/grey energy accounting using the local GreenPowerIndex. Returns the account, timestamp and available green and standard electricity CO₂ data.

Input Parameters

string
German postal code (5 digits) of the metered location.
integer
Meter reading value in watt-hours (Wh). This is an alias for the ‘1.8.0’ OBIS code field. Provide either ‘energy’ or ‘1_8_0’, not both.
string
Private password for meter updates. Required if the meter is protected.
string
Stromkonto account (address) associated with this metering.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CORRENTLY_PREPARE_RECEIPT_DATAPrepare receipt data with an optional session account identifier. Returns the API response as a string, which may contain the account identifier.

Input Parameters

string
Quittung session account identifier returned from the first call. Omit this parameter on the first request to create a new session. Include it in subsequent requests to extend or update the existing collection.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CORRENTLY_PV_GENERATION_GET_FORECASTGet hourly solar PV generation forecasts for a German location. Returns predicted energy output in watt-hours (Wh) for each hour over the specified forecast period. Use this tool when you need to optimize energy scheduling, estimate solar production, or plan energy storage based on expected PV generation.

Input Parameters

integer
Number of days to forecast (1-7). Defaults to 7 days if not specified.
number
required
Installed photovoltaic system capacity in watts (W). Typical residential systems range from 3000 to 10000 watts.
string
required
German postal code (PLZ) for the location. Must be a valid 5-digit German ZIP code.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CORRENTLY_REGISTER_STROMKONTOTool to register a new Stromkonto energy account in the Corrently system. Use when creating a new account with email, name, and location details. All balances are initialized to zero upon registration.

Input Parameters

string
required
Email address for the new account holder.
string
required
Five-digit German postal code (Postleitzahl) for the account location.
string
required
Last name of the account holder.
string
required
First name of the account holder.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CORRENTLY_RENEWABLE_ENERGY_DISPATCHTool to get renewable energy flow and mix for a German ZIP code. Use when you need import/export and dispatch sources/destinations breakdown.

Input Parameters

string
required
German postal (ZIP) code to analyze.
string
Optional access token for extended or paid access; if provided, sent as query parameter ‘token’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CORRENTLY_STROMMIXRetrieve Germany’s electricity generation mix, including generation totals and source breakdowns for the period returned by the API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CORRENTLY_TARIFF_COMPONENTSRetrieve detailed German electricity tariff cost breakdown by postal code. Returns comprehensive cost components including: - Grundgebühr (base monthly fee) - Arbeitspreis (energy price per kWh) - Network fees (Netznutzungsentgelt) - Taxes (Stromsteuer, Mehrwertsteuer) - Levies (EEG, KWKG, Offshore-Netzumlage) - Renewable energy credits Use this tool to understand electricity pricing transparency in Germany.

Input Parameters

integer
Energy amount in watt-hours for a specific event. Requires ‘milliseconds’ to be set.
integer
Annual energy consumption in kWh/year. Used to calculate total annual costs. Typical household: 2000-4000 kWh.
string
required
Email address for API request attribution (required by API). Can be any valid email format.
string
required
German postal code (5-digit PLZ) to get local tariff components. Example: ‘80331’ for Munich.
integer
Timeframe in milliseconds for scaling calculations. Use with ‘wh’ for specific energy events.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CORRENTLY_TARIFF_SLPH0Tool to retrieve standard load profile H0 tariff information. Use after providing a German postal code to get local SLPH0 tariffs.

Input Parameters

string
German postal code (Postleitzahl) to scope the SLPH0 tariff (5 digits).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CORRENTLY_WEATHER_FORECASTTool to retrieve hourly weather forecasts (wind speed and UV index) by geographic coordinates. Use when you need wind and UV data for a specific location. Returns up to 5 days of hourly forecasts.

Input Parameters

number
required
Latitude in decimal degrees (-90 to 90). Required.
number
required
Longitude in decimal degrees (-180 to 180). Required.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not