home-assistant.io/source/_integrations/watttime.markdown

title, description, ha_category, ha_release, ha_iot_class, ha_domain, ha_codeowners, ha_config_flow, ha_platforms

title	description	ha_category	ha_release	ha_iot_class	ha_domain	ha_codeowners	ha_config_flow	ha_platforms
WattTime	Instructions on how to set up the WattTime integration within Home Assistant.	Sensor	2021.10	Cloud Polling	watttime	@bachya	true	sensor

The watttime integration allows users to get real-time emissions data for a latitude/longitude from WattTime.

Registering an Account

WattTime account registration is accomplished via the REST API itself. The simplest way to do this is by using cURL on the command line:

curl -X "POST" "https://api2.watttime.org/v2/register" \
     -H 'Content-Type: application/json; charset=utf-8' \
     -d $'{
       "username": "<USERNAME>",
       "password": "<PASSWORD>",
       "email": "<EMAIL>",
       "org": "<ORG>"
     }'

Note that the org value can be anything you like – it doesn't need to represent a real entity.

{% include integrations/config_flow.md %}

Sensors

The sensors available to you will depend on the type of WattTime subscription you have. You can reach out to WattTime to upgrade your subscription via [their website](https://www.watttime.org/contact/).

Name	Subscription Level	Meaning
Marginal Operating Emissions Rate	Pro	The currently measured amount of lbs of CO2 per MWh
Relative Marginal Emissions Intensity	All	A percentage between the lowest (cleanest) and highest (highest) MOER values observed in the past two weeks

You can learn more about the data that WattTime collects by viewing these articles:

• https://www.watttime.org/aer/what-is-aer/
• https://www.watttime.org/aer/how-aer-works/