curl --request POST \
--url https://api.partner.cubee.cz/api/v2/savings-calculator \
--header 'Content-Type: application/json' \
--data '
{
"periodType": "2025",
"yearlyConsumptionKWh": 4000,
"totalKWp": 7,
"battery": {
"batterySizeKwh": 10,
"reservedBatteryCapacityPercentage": 15
},
"distribution": {
"distributor": "CEZ",
"distributionRate": "D02d",
"distributorFeeHighPerMWh": 2000,
"distributorFeeLowPerMWh": 0,
"renewableEnergyFeePerMWh": 0,
"systemServicesFeePerMWh": 212,
"circuitBreakerMonthlyFee": 236
},
"electricityBuyingSettings": {
"fixedBuyPriceCzkPerMWh": 3500,
"fixedBuyPriceCzkPerMwhInLowTariff": 3500,
"buyingType": "FIX",
"monthlyFeeCzk": 100,
"vat": 21
},
"electricitySellingSettings": {
"fixedSellPriceCzkPerMWh": 500,
"sellingType": "FIX",
"monthlyFeeCzk": 0
}
}
'{
"withoutPV": {
"energyProducedKWh": 123,
"energyConsumedKWh": 123,
"energyPurchasedKWh": 123,
"energySoldKWh": 123,
"costOfPurchasedEnergy": 123,
"revenueFromSoldEnergy": 123,
"energyNotSoldDueToNegativePriceLimitationKWh": 123,
"savingsFromNotSoldEnergyToNegativePrice": 123,
"netEnergyCost": 123,
"averagePurchasePricePerMWh": 123,
"averageSellPricePerMWh": 123
},
"basicPV": {
"energyProducedKWh": 123,
"energyConsumedKWh": 123,
"energyPurchasedKWh": 123,
"energySoldKWh": 123,
"costOfPurchasedEnergy": 123,
"revenueFromSoldEnergy": 123,
"energyNotSoldDueToNegativePriceLimitationKWh": 123,
"savingsFromNotSoldEnergyToNegativePrice": 123,
"netEnergyCost": 123,
"averagePurchasePricePerMWh": 123,
"averageSellPricePerMWh": 123
},
"smartPV": {
"energyProducedKWh": 123,
"energyConsumedKWh": 123,
"energyPurchasedKWh": 123,
"energySoldKWh": 123,
"costOfPurchasedEnergy": 123,
"revenueFromSoldEnergy": 123,
"energyNotSoldDueToNegativePriceLimitationKWh": 123,
"savingsFromNotSoldEnergyToNegativePrice": 123,
"netEnergyCost": 123,
"averagePurchasePricePerMWh": 123,
"averageSellPricePerMWh": 123
},
"savingsComparedToBasicPV": 123,
"months": [
{
"withoutPV": {
"energyProducedKWh": 123,
"energyConsumedKWh": 123,
"energyPurchasedKWh": 123,
"energySoldKWh": 123,
"costOfPurchasedEnergy": 123,
"revenueFromSoldEnergy": 123,
"energyNotSoldDueToNegativePriceLimitationKWh": 123,
"savingsFromNotSoldEnergyToNegativePrice": 123,
"netEnergyCost": 123,
"averagePurchasePricePerMWh": 123,
"averageSellPricePerMWh": 123
},
"basicPV": {
"energyProducedKWh": 123,
"energyConsumedKWh": 123,
"energyPurchasedKWh": 123,
"energySoldKWh": 123,
"costOfPurchasedEnergy": 123,
"revenueFromSoldEnergy": 123,
"energyNotSoldDueToNegativePriceLimitationKWh": 123,
"savingsFromNotSoldEnergyToNegativePrice": 123,
"netEnergyCost": 123,
"averagePurchasePricePerMWh": 123,
"averageSellPricePerMWh": 123
},
"smartPV": {
"energyProducedKWh": 123,
"energyConsumedKWh": 123,
"energyPurchasedKWh": 123,
"energySoldKWh": 123,
"costOfPurchasedEnergy": 123,
"revenueFromSoldEnergy": 123,
"energyNotSoldDueToNegativePriceLimitationKWh": 123,
"savingsFromNotSoldEnergyToNegativePrice": 123,
"netEnergyCost": 123,
"averagePurchasePricePerMWh": 123,
"averageSellPricePerMWh": 123
},
"savingsComparedToBasicPV": 123,
"month": "2023-12-25"
}
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}Savings calculator
Calculates savings for Basic PV, smart PV and No PV installations.
curl --request POST \
--url https://api.partner.cubee.cz/api/v2/savings-calculator \
--header 'Content-Type: application/json' \
--data '
{
"periodType": "2025",
"yearlyConsumptionKWh": 4000,
"totalKWp": 7,
"battery": {
"batterySizeKwh": 10,
"reservedBatteryCapacityPercentage": 15
},
"distribution": {
"distributor": "CEZ",
"distributionRate": "D02d",
"distributorFeeHighPerMWh": 2000,
"distributorFeeLowPerMWh": 0,
"renewableEnergyFeePerMWh": 0,
"systemServicesFeePerMWh": 212,
"circuitBreakerMonthlyFee": 236
},
"electricityBuyingSettings": {
"fixedBuyPriceCzkPerMWh": 3500,
"fixedBuyPriceCzkPerMwhInLowTariff": 3500,
"buyingType": "FIX",
"monthlyFeeCzk": 100,
"vat": 21
},
"electricitySellingSettings": {
"fixedSellPriceCzkPerMWh": 500,
"sellingType": "FIX",
"monthlyFeeCzk": 0
}
}
'{
"withoutPV": {
"energyProducedKWh": 123,
"energyConsumedKWh": 123,
"energyPurchasedKWh": 123,
"energySoldKWh": 123,
"costOfPurchasedEnergy": 123,
"revenueFromSoldEnergy": 123,
"energyNotSoldDueToNegativePriceLimitationKWh": 123,
"savingsFromNotSoldEnergyToNegativePrice": 123,
"netEnergyCost": 123,
"averagePurchasePricePerMWh": 123,
"averageSellPricePerMWh": 123
},
"basicPV": {
"energyProducedKWh": 123,
"energyConsumedKWh": 123,
"energyPurchasedKWh": 123,
"energySoldKWh": 123,
"costOfPurchasedEnergy": 123,
"revenueFromSoldEnergy": 123,
"energyNotSoldDueToNegativePriceLimitationKWh": 123,
"savingsFromNotSoldEnergyToNegativePrice": 123,
"netEnergyCost": 123,
"averagePurchasePricePerMWh": 123,
"averageSellPricePerMWh": 123
},
"smartPV": {
"energyProducedKWh": 123,
"energyConsumedKWh": 123,
"energyPurchasedKWh": 123,
"energySoldKWh": 123,
"costOfPurchasedEnergy": 123,
"revenueFromSoldEnergy": 123,
"energyNotSoldDueToNegativePriceLimitationKWh": 123,
"savingsFromNotSoldEnergyToNegativePrice": 123,
"netEnergyCost": 123,
"averagePurchasePricePerMWh": 123,
"averageSellPricePerMWh": 123
},
"savingsComparedToBasicPV": 123,
"months": [
{
"withoutPV": {
"energyProducedKWh": 123,
"energyConsumedKWh": 123,
"energyPurchasedKWh": 123,
"energySoldKWh": 123,
"costOfPurchasedEnergy": 123,
"revenueFromSoldEnergy": 123,
"energyNotSoldDueToNegativePriceLimitationKWh": 123,
"savingsFromNotSoldEnergyToNegativePrice": 123,
"netEnergyCost": 123,
"averagePurchasePricePerMWh": 123,
"averageSellPricePerMWh": 123
},
"basicPV": {
"energyProducedKWh": 123,
"energyConsumedKWh": 123,
"energyPurchasedKWh": 123,
"energySoldKWh": 123,
"costOfPurchasedEnergy": 123,
"revenueFromSoldEnergy": 123,
"energyNotSoldDueToNegativePriceLimitationKWh": 123,
"savingsFromNotSoldEnergyToNegativePrice": 123,
"netEnergyCost": 123,
"averagePurchasePricePerMWh": 123,
"averageSellPricePerMWh": 123
},
"smartPV": {
"energyProducedKWh": 123,
"energyConsumedKWh": 123,
"energyPurchasedKWh": 123,
"energySoldKWh": 123,
"costOfPurchasedEnergy": 123,
"revenueFromSoldEnergy": 123,
"energyNotSoldDueToNegativePriceLimitationKWh": 123,
"savingsFromNotSoldEnergyToNegativePrice": 123,
"netEnergyCost": 123,
"averagePurchasePricePerMWh": 123,
"averageSellPricePerMWh": 123
},
"savingsComparedToBasicPV": 123,
"month": "2023-12-25"
}
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}Body
Input model with all available parameters to set.
Main input model for the savings calculator.
Combines panel, battery, distribution, and electricity pricing configurations.
Total installed PV power - kWp.
Constraints: The system currently supports only a single PV array, so this represents the total capacity.
If you need to create custom production profiles, use the CustomProductionConsumptionData property instead.
Configuration of the battery system used in the simulation.
Show child attributes
Show child attributes
Settings related to the electricity distributor and regulated fees.
Show child attributes
Show child attributes
Configuration for electricity purchasing strategy (either fixed or spot-based).
- FixBuyingSettings
- SpotBuyingSettings
Show child attributes
Show child attributes
Type of time period to evaluate — a specific year like "2024", "2025", or the rolling range "12M"
(last 12 completed months). Accepted values come from GET /api/v1/reference/periods.
Optional: leave it null and set from + to instead to evaluate an explicit date range.
When both from and to are provided this field is ignored. Exactly one of
{ periodType } or { from + to } must be supplied.
Optional explicit start of the evaluation period (date only, inclusive), e.g. "2025-01-01". Must be set
together with to. When both are set, periodType is ignored — this lets you pin the exact
window a study was computed over (e.g. a "last 12 months" run) so it can be reproduced later. The range
must fall within the available data window (see the 400 response for the allowed bounds).
Optional explicit end of the evaluation period (date only, inclusive), e.g. "2025-12-31". Must be set
together with from. The whole day is included. A full calendar year (from = Jan 1, to = Dec 31)
yields the same result as the matching periodType year.
Estimated total annual electricity consumption of the household in kilowatt-hours (kWh).
Configuration for electricity selling strategy (if can't sell, set null).
- FixSellingSettings
- SpotSellingSettings
Show child attributes
Show child attributes
Optional custom production and consumption data for more accurate modeling.
This is not required; if not provided, the model will use default estimations based on TotalKWp and YearlyConsumptionKWh.
Model requires 1 hour granularity data for the entire period specified in PeriodType.
Show child attributes
Show child attributes
Response
OK
Represents the final results of the savings calculation, including aggregated energy usage and cost data for different system configurations, as well as a breakdown by month.
Represents aggregated energy and cost data for a specific PV system configuration.
Show child attributes
Show child attributes
Represents aggregated energy and cost data for a specific PV system configuration.
Show child attributes
Show child attributes
Represents aggregated energy and cost data for a specific PV system configuration.
Show child attributes
Show child attributes
The amount of money saved by using the smart PV system with Cubee compared to the basic PV system without optimization.
A list of monthly breakdowns showing energy data and savings for each individual month in the evaluation period.
Show child attributes
Show child attributes
Was this page helpful?