Skip to main content
WattShift’s Impact Calculations enable you to quantify the financial and environmental impact of energy usage patterns. Whether you’re analyzing short-term or long-term scenarios, actual or counter-factual cases, or forecasted versus historical data, you can provide interval usage data and receive comprehensive calculations for bill costs, grid revenue, and CO₂e emissions. This is extremely useful for providing two cases and observing the changes in GHG and $ flows, helping you understand the value of different energy management strategies.

​
Key Use Cases

  • Solar + Battery ROI: Evaluate the return on investment for solar and battery systems, even under complex export tariffs like NEM3.0 and VDER
  • Device Savings: Accurately estimate the financial and environmental savings from smart device operations
  • Tariff Optimization: Identify potential savings by analyzing different utility tariffs and selecting the most cost-effective options
  • EV Cost Analysis: Determine the marginal cost of each electric vehicle charging session to optimize charging schedules
  • Scenario Comparison: Compare actual vs. counter-factual scenarios to understand the impact of different energy management strategies

​
API Endpoint

To calculate monthly bill impacts, use the following endpoint: [POST] /v1/homes/<homeId>/bill/monthly
[!IMPORTANT] Prerequisite: Before calling this endpoint, ensure the home has a utilityId and ratePlanId set.
  • Primary Method: Set these values during the API Based Onboarding process.
  • Secondary Method: Use the Update Home endpoint if you need to set or change these values after onboarding.
Refer to Rate Plan IDs for details on finding and using rate plans.

​
Request

Provide the usage data for the month you want to calculate the bill for.
[!WARNING] Strict Day Count Requirement: The usage array must contain an entry for every single day of the month.
  • If the month has 31 days (e.g., January), you must provide 31 arrays.
  • If it is February in a leap year, you must provide 29 arrays.
  • The call will fail if the number of days provided does not exactly match the number of days in the specified month.
The usage data should be an array of arrays, where each inner array represents a day’s usage in 15-minute intervals (96 intervals per day). 
{
  "usage": [
      [
        0.18, 0.16, 0.11, 0.09, 0.13, 0.11, 0.17, 0.1, 0.12, 0.14, 0.19, 0.13,
        0.09, 0.16, 0.14, 0.09, 0.19, 0.2, 0.17, 0.19, 0.1, 0.16, 0.18, 0.15,
        0.49, 0.34, 0.47, 0.54, 0.67, 0.69, 0.49, 0.65, 0.4, 0.62, 0.52, 0.31,
        0.37, 0.27, 0.4, 0.35, 0.15, 0.3, 0.41, 0.22, 0.25, 0.41, 0.21, 0.32,
        0.22, 0.44, 0.39, 0.28, 0.17, 0.25, 0.3, 0.43, 0.18, 0.32, 0.36, 0.31,
        0.39, 0.31, 0.44, 0.33, 0.33, 0.28, 0.33, 0.27, 0.75, 0.57, 0.51, 0.51,
        0.77, 0.79, 0.69, 0.45, 0.85, 0.93, 0.95, 0.91, 0.94, 0.95, 0.72, 0.63,
        0.82, 0.57, 0.89, 0.91, 0.47, 0.38, 0.48, 0.37, 0.34, 0.4, 0.5, 0.48
      ],
      // ... more days
  ],
  "month": 1,
  "year": 2025
}

​
Request Fields

  • usage: A 2D array of numbers representing energy usage in kWh. Each inner array corresponds to a day, containing 96 values for 15-minute intervals.
  • month: The month for which the bill is being calculated (1-12).
  • year: The year for which the bill is being calculated (e.g., 2025).

​
Response

The response provides comprehensive financial and environmental impact metrics: 
{
  "startTime": "2025-02-25T16:13:37.902Z",
  "endTime": "2025-02-26T16:13:37.902Z",
  "duration": "PT24H",
  "billTotal": 132.56,  // local currency USD or CAD
  "gridServicesRev": 25.34,  // local currency USD or CAD
  "CO2e": 300  // lbs of marginal GHG
}

​
Response Fields

  • startTime: The start time of the analysis period
  • endTime: The end time of the analysis period
  • duration: ISO 8601 duration string representing the time period analyzed
  • billTotal: Total bill cost in local currency (USD or CAD)
  • gridServicesRev: Grid services revenue in local currency (USD or CAD)
  • CO2e: Carbon dioxide equivalent emissions in pounds (lbs) of marginal greenhouse gas

​
Important Notes

Billing Period Matching: Queries that don’t precisely match a customer’s billing period are useful for relative bill calculations but will not precisely match the total number on the customer’s bill. For exact bill matching, ensure your query period aligns with the customer’s actual billing cycle.

​
How It Works

WattShift aggregates data from five grid incentive categories to create a unified, actionable optimization signal:
  1. Utility Tariffs: Simplifies complex rate structures to identify cost-saving opportunities
  2. Wholesale Prices: Incorporates real-time market signals to inform energy usage decisions
  3. Solar Export Rates: Considers net metering and export values to maximize the benefits of solar energy production
  4. Demand Response: Evaluates grid service opportunities to generate additional revenue
  5. Carbon Intensity: Assesses environmental impact pricing to reduce carbon emissions
By integrating these factors, WattShift provides a comprehensive view of energy costs and environmental impacts, enabling you to make informed decisions about energy management strategies.