Green Button data is the hourly or 15-minute usage your smart meter records, delivered in a standard file you can download from your utility’s website (Green Button Download My Data) or have sent automatically to a company you authorize (Green Button Connect My Data). To get it, log in to your utility account, look for “Green Button” or “Download my data” in the usage section, and ask for at least twelve months at the finest interval offered. Read against your rate schedule, the file shows what share of your use falls in each price window, your highest 15-minute demand, your overnight base load and what an EV or electric heat adds. Those four numbers decide most rate switches and most battery, solar and charger sizing questions.
This guide explains the two Green Button services, what the file contains, how to clean it, and then reads one fictional interval file against LG&E’s published time-of-day windows. Utility details are as of November 2026.
What Green Button data is
Green Button is a common format for utility usage data, so a file from one utility can be read by the same tools as a file from another. The US Department of Energy describes it as “an industry-led effort that responds to a White House call-to-action,” launched in January 2012 so that customers can “securely download their own detailed energy usage” from their utility’s website (DOE, Green Button). The same page says the format rests on a data standard released by the North American Energy Standards Board (NAESB) in the fall of 2011.
The National Institute of Standards and Technology names that standard: Green Button “is based on a common technical standard,” the Energy Services Provider Interface, or ESPI, developed with the Smart Grid Interoperability Panel (NIST, Green Button initiative). Today the Green Button Alliance maintains the standards, runs a testing and certification program for utility platforms, and publishes a directory of utilities and service providers. The Alliance says the format covers electricity, natural gas and water usage.
How many utilities offer it is harder to pin down. DOE’s page says “over 50 utilities and electricity suppliers have signed on” and that over 60 million homes and businesses would be able to access their data. Those figures date from the early years of the initiative, even though the page itself was last updated in May 2026, so treat them as history rather than a current count. The only reliable test is your own utility account.
Interval data and your bill are different records
Interval data is a series of meter readings, each covering a fixed block of time such as 15 minutes or one hour. Your bill adds those readings into one or two totals for the billing period. The bill tells you how much you used; the interval data tells you when.
That difference only exists if your meter records intervals. The US Energy Information Administration defines advanced metering infrastructure (AMI) meters as meters that “measure and record electricity usage at a minimum of hourly intervals” and “provide the data to both the utility and the utility customer at least once a day” (EIA FAQ, updated October 2023). EIA counted about 119 million AMI installations in 2022, and about 73% of residential electric meters were AMI meters. NIST notes that a Green Button file may hold hourly interval data, “typically available a day afterward,” or only monthly data, depending on what the utility has.
Download My Data and Connect My Data: the two ways to get it
Download My Data gives you a file that you keep and pass on yourself; Connect My Data lets the utility send your data straight to a company you name, on a schedule, until the authorization ends. The first is a snapshot. The second is standing access.
The Green Button Alliance describes Download My Data as the “download-and-share component” of the standards, delivering usage “in an industry-standard XML format” from your energy provider’s website (Green Button Alliance, Download My Data). It calls Connect My Data the “authorize-and-share component,” and says “the customer can define the length of that authorization and revoke authorization at any time” (Green Button Alliance, Connect My Data).
| Download My Data | Connect My Data | |
|---|---|---|
| What happens | You sign in, choose dates and download a file | You authorize a named company; the utility transfers your data to it directly |
| Format | XML in the standard; many utilities also offer a CSV for spreadsheets | Standard data sent through the utility’s interface; you never handle a file |
| Updates | None: the file covers the dates you chose | New data keeps flowing until the authorization ends or you revoke it |
| Who holds copies | You, and anyone you send the file to | The company you authorized, under its own data policy |
| Good for | Checking a rate yourself, or sending a year of use to an installer or planner | Ongoing monitoring, monthly bill checks, program enrollment |
| What to watch | A file sent by email cannot be recalled | Scope (usage only, or billing and account details too) and the end date |
For a one-time decision, such as whether to switch rates or how large a battery to buy, Download My Data is usually enough. Connect My Data earns its place when a service needs fresh data every month and you are comfortable with that company holding it.
How to download your usage, step by step
Most utilities put Green Button inside the usage or billing pages of your online account, and the steps are similar everywhere. The details that differ are the interval length, how much history you can pull at once and which file formats you can choose.
- Confirm you have a smart meter. Interval data exists only if the meter records it. At LG&E and KU, the My Meter dashboard “is available through My Account to all customers with an advanced meter” (LG&E and KU, My Meter).
- Sign in and find the download. Look in the usage section for “Green Button,” “Download my data” or a green button icon. At LG&E and KU it sits inside My Meter, which offers both Download My Data and Connect My Data (LG&E and KU, Green Button data).
- Choose the finest interval offered. Fifteen-minute data shows short spikes that hourly data averages away. Hourly data is enough for time-of-use questions.
- Choose at least twelve full months. A year covers both seasons of a time-of-use rate. Ask for thirteen months if you can, so the first and last months are complete. If the site limits the range of one download, pull the year in pieces and join them.
- Choose the format. Pick CSV if you will open the file in a spreadsheet, XML if a program or an installer’s software will read it. Download both if both are offered.
- Download each service separately. Electric and gas, or two electric meters, usually come as separate files or separate sections of one file. Solar homes should check whether the file includes energy sent to the grid.
- Label the file and write down what changed. Name it with the account and date range, and note the months when an EV, heat pump, solar array or new household member arrived, or when the house sat empty.
What some utilities publish about intervals and history
Utilities publish their own limits, and they vary. The table shows what four public pages say, as checked in November 2026; your utility’s account pages are the record for your home.
| Utility or source | Where to look | What the page says about intervals and history | Formats named |
|---|---|---|---|
| LG&E and KU (Kentucky) | My Meter, inside My Account | Lets you “access, download, and send your monthly or incremental energy use data”; interval length and history are not stated | XML for Download My Data; Connect My Data for authorized third parties |
| Con Edison (New York) | My Account, billing and usage | “Up to one year of energy use data” in a spreadsheet | CSV or XML |
| PG&E (California) | Your account, My Usage | A 2017 PG&E summary lists residential Green Button downloads with interval usage and costs back to December 2011, about two business days behind | CSV and XML |
| OpenEI reference page | Not a utility | A launch-era description says customers can download up to 13 months, if they have that much history | Not stated |
Sources: Con Edison, Green Button, PG&E, Summary of Data Access Programs, OpenEI, Green Button. The OpenEI map of utilities is marked current as of October 2012, which is a reminder of how old most published lists are.
What is inside a Green Button file
An XML Green Button file is a list of readings, each with a start time, a duration and a value, plus a header that says what the numbers mean. Read the header first: the values are integers in watt-hours unless the header says to scale them, and the times are counted in seconds rather than written as dates.
The Green Button Alliance’s certification tests require each interval file to contain an IntervalBlock of IntervalReading entries, each with a start, a duration and a value, and a ReadingType entry with an interval length, a power-of-ten multiplier and a unit of measure (Green Button Alliance, FB_04 interval metering). The fields that matter for a homeowner are these.
| Field | What it means | What to do with it |
|---|---|---|
| uom (unit of measure) | Code 72 is “Real energy, Watt hours, Wh”; the Alliance notes “there is no kWh (kilowatt-hour) option” | Divide by 1,000 to get kWh |
| powerOfTenMultiplier | Scales every value: the reading equals value x 10 to that power, in the unit above | Apply it before anything else; values are always whole numbers |
| intervalLength | Seconds per reading: 3600 is one hour, 900 is 15 minutes | The Alliance says residential smart meter data is “usually 3600” |
| accumulationBehaviour | Code 4 means each reading is the energy used during that interval | Sum readings to get totals; do not subtract them |
| flowDirection | Code 1 is “forward,” energy delivered to you | Solar homes: confirm whether exports are in a separate reading type |
| timePeriod start | The interval’s start, in seconds since January 1, 1970, in Coordinated Universal Time (UTC) | Convert to your local clock, then to your tariff’s clock |
| timePeriod duration | The interval’s length in seconds | Should match intervalLength |
| ReadingQuality | Optional flags; 19 is “revenue-quality,” 8 and 9 are estimated readings, 10 is “questionable” | Count how many readings are estimated before you rely on a month |
Sources for the codes: the Alliance’s pages on the power-of-ten multiplier and on accuracy and reading quality. The Alliance’s accuracy example uses a start of 1767225600, which works out to midnight UTC on January 1, 2026, a quick check that the start values are UTC seconds.
Here is a shortened excerpt laid out the way the Alliance’s examples are, with fictional values for one hour.
<espi:ReadingType>
<espi:accumulationBehaviour>4</espi:accumulationBehaviour>
<espi:commodity>1</espi:commodity>
<espi:flowDirection>1</espi:flowDirection>
<espi:intervalLength>3600</espi:intervalLength>
<espi:powerOfTenMultiplier>0</espi:powerOfTenMultiplier>
<espi:uom>72</espi:uom>
</espi:ReadingType>
<espi:IntervalReading>
<espi:timePeriod>
<espi:duration>3600</espi:duration>
<espi:start>1784138400</espi:start>
</espi:timePeriod>
<espi:value>1900</espi:value>
</espi:IntervalReading>
Read it in three moves. The start, 1784138400 seconds, is 6 p.m. UTC on July 15, 2026, which is 2 p.m. Eastern Daylight Time. The value, 1900 with a multiplier of 0 in watt-hours, is 1,900 Wh, or 1.9 kWh. So the home used 1.9 kWh from 2 to 3 p.m. that Wednesday.
CSV downloads are easier to open and easier to misread
A CSV export puts one reading per row with a date, a time and a usage column, and it opens in any spreadsheet. The Green Button standard fixes the XML structure, not the CSV layout, so check four things in the column headers or the utility’s help page before you sum anything:
- Units. kWh or Wh, and whether there is a separate column for energy sent to the grid.
- Start or end. Whether “2:00 p.m.” labels the interval that starts at 2:00 or the one that ends at 2:00. A one-interval shift moves usage across a rate boundary.
- Time zone. Whether times are local clock time, standard time or UTC.
- Daylight saving days. On the spring change, a local-time file has 23 hours; on the fall change it has 25. Check how the file shows the missing and the repeated hour.
Clean the file before you trust it
A Green Button file is the meter’s record, but the way it is exported can still mislead you. Ten minutes of checks before any arithmetic prevents most wrong answers.
- Put every reading on the tariff’s clock. Convert UTC to local time, then to the clock your rate schedule uses. LG&E and KU set their time-of-day windows “in Eastern Standard Time year-round,” so during daylight time every window sits one hour later on a wall clock (LG&E tariff, Sheet No. 6.1).
- Count readings per day. A full day has 24 hourly or 96 fifteen-minute readings in UTC. In local time, the spring change day has 23 hours and the fall change day 25.
- Find gaps and duplicates. A missing hour shrinks a month’s total; a duplicated hour inflates it. Both happen when files covering adjacent ranges are joined.
- Count estimated readings. If a month has many readings flagged as estimated, use it with care or leave it out of a rate comparison.
- Know what the solar channel measures. For a home with rooftop solar, ask whether the file holds energy delivered to the home, energy received from the home, or the net of the two in each interval. Net data understates what the house actually used while the panels were producing.
- Mark the events you noted. A month with an empty house or a new car is not a typical month. Keep it, but do not let it set the answer alone.
- Tie the totals to your bills. Add each billing period’s intervals and compare with the kWh on the bill. Small differences come from billing periods that do not match calendar months; large ones mean a joining or unit error.
A worked read: one July file against LG&E’s time-of-day windows
To read an interval file against a time-of-use schedule, tag every interval with its rating period, add up the kWh in each period, and price each total at that period’s rate. The only hard part is getting the clock right.
The published schedule here is LG&E’s optional Residential Time-of-Day Energy rate, RTOD-Energy. From April through October, the on-peak period is weekdays from 1 to 5 p.m. Eastern Standard Time, everything else is off-peak, weekends are off-peak all day, and “if a legal holiday falls on a weekday, it will be considered a weekday” (Sheet No. 6.1). Effective September 1, 2026, the energy charges are $0.09312 per kWh off-peak and $0.19307 on-peak, against $0.11499 per kWh on the standard residential Rate RS; both rates carry the same $0.48 per day basic service charge (Sheets No. 5 and 6). These are base charges before riders and taxes.
Example (fictional). A Louisville-area home on LG&E Rate RS, with central air conditioning and no EV or solar, downloads an hourly XML file for July 2026. The readings for Wednesday, July 15 add up to 31.6 kWh.
Step 1: convert the clock. The tariff’s 1 to 5 p.m. EST is 2 to 6 p.m. on a daylight-time clock, which is 6 to 10 p.m. UTC. In the file, the on-peak intervals are the four whose starts fall from 1784138400 to 1784149200.
| Local time (EDT) | Start in the file (UTC seconds) | Value (Wh) | kWh | Rating period |
|---|---|---|---|---|
| 1 to 2 p.m. | 1784134800 | 1600 | 1.6 | Off-peak |
| 2 to 3 p.m. | 1784138400 | 1900 | 1.9 | On-peak |
| 3 to 4 p.m. | 1784142000 | 2100 | 2.1 | On-peak |
| 4 to 5 p.m. | 1784145600 | 2300 | 2.3 | On-peak |
| 5 to 6 p.m. | 1784149200 | 2600 | 2.6 | On-peak |
| 6 to 7 p.m. | 1784152800 | 2400 | 2.4 | Off-peak |
Step 2: sum the day. On-peak: 1.9 + 2.1 + 2.3 + 2.6 = 8.9 kWh, which is 8.9 / 31.6 = 28.2% of the day.
Step 3: sum the month. July 2026 has 23 weekdays, including Friday, July 3, the federal holiday observance, which the tariff counts as a weekday, and 8 weekend days. Suppose every weekday looked like July 15 and weekend days averaged 33.0 kWh, all off-peak. Weekdays: 23 x 31.6 = 726.8 kWh. Weekends: 8 x 33.0 = 264.0 kWh. Total: 990.8 kWh. On-peak: 23 x 8.9 = 204.7 kWh, which is 204.7 / 990.8 = 20.7% of the month.
Step 4: price both rates. Rate RS: 990.8 kWh x $0.11499 = $113.93. RTOD-Energy: 204.7 kWh x $0.19307 = $39.52, plus 786.1 kWh x $0.09312 = $73.20, for $112.72. On base energy charges, this July would have cost $1.21 less on RTOD-Energy. The basic service charge is the same on both rates, so it drops out of the comparison.
Two things in this example matter more than the $1.21. First, the clock: if the homeowner had read “1 to 5 p.m.” as wall-clock time, the day’s on-peak total would have been 1.6 + 1.9 + 2.1 + 2.3 = 7.9 kWh (25.0%) instead of 8.9 kWh, and the hour from 5 to 6 p.m., the most expensive one, would have been priced as off-peak. Second, one month is not a year. From November through March, LG&E’s on-peak periods are 6 to 10 a.m. and 6 to 10 p.m. EST on weekdays, eight hours a day instead of four, and a home with electric heat or a heat pump may put a much larger share of its winter use into those hours.
A full decision runs the same four steps for all twelve months and compares the year. The article on LG&E and KU time-of-day rates does that comparison for both utilities, including the demand-based option. If you already know your share of on-peak use, the rate plan comparison calculator prices it for you; for a two-period rate like this one, enter the off-peak price as the day price too.
Five things the data tells you before you change rates or buy equipment
A year of interval data answers five practical questions that a stack of bills cannot. Each one feeds a specific decision, and each takes a few minutes in a spreadsheet once the file is clean.
| Question | What to compute from the file | Decision it informs |
|---|---|---|
| How much of my use falls in each rate window? | kWh per rating period, per month, as a share of the total | Whether a time-of-use rate beats a flat rate for you |
| What is my highest short-term demand? | The largest 15-minute reading, converted to kW | Demand-charge rates; conversations with an electrician about panel and charger capacity |
| What does the house use when nothing is happening? | The average of the lowest overnight hours | Where waste hides; how fast a battery drains in an outage |
| What does the EV or the electric heat add? | Before-and-after months, or the distinctive blocks those loads leave | How much load can move, and when |
| How much would a battery or solar need to cover? | kWh in the expensive window each weekday; daytime kWh for solar | Battery usable capacity; solar size and self-use |
1. The share of your use in each rate window
A time-of-use rate beats a flat rate when the share of your use in its expensive hours is below a break-even share. For a two-period rate, the break-even share is (flat price minus off-peak price) divided by (on-peak price minus off-peak price). With LG&E’s prices above, that is ($0.11499 minus $0.09312) / ($0.19307 minus $0.09312) = $0.02187 / $0.09995 = 21.9%.
Your file gives you the other side of the comparison: your own on-peak share, month by month. Compute it for each month rather than for the year as a whole, because the windows change with the season and so does your use. Then ask how much of the on-peak use could move: a dishwasher on a delay timer can, a summer afternoon of air conditioning mostly cannot. The time-of-use rates guide explains the mechanism across other utilities’ schedules.
2. Your highest 15-minute demand
Demand is the rate of use, in kW, and interval data lets you measure it. Convert any reading to average kW by dividing the kWh by the interval length in hours: a 15-minute reading of 1.05 kWh is 1.05 / 0.25 = 4.2 kW.
Interval length changes the answer. An hourly file averages over 60 minutes, so a 20-minute burst of an oven, a dryer and an air conditioner running together shows up diluted. In the July example, the highest hour was 2.6 kWh, an average of 2.6 kW; the highest 15 minutes inside that hour could easily be higher, and only a 15-minute file shows it.
This number matters on rates with demand charges. LG&E’s optional RTOD-Demand rate measures demand as “the average kW demand delivered to the Customer during the 15-minute period of maximum use,” with a charge per kW for base hours and a higher one for peak hours (Sheets No. 7 and 7.1). The guide to residential demand charges shows how those charges are built. The same number is a useful starting point when you talk to a licensed electrician about adding a charger or heat pump, though the electrician’s load calculation, not your file, decides what the panel can carry.
3. Your overnight base load
Base load is what the house uses when nobody is doing anything: refrigerators, the furnace fan, network gear, standby power, a dehumidifier. Find it by averaging the lowest overnight hours, say 1 to 5 a.m., across a few weeks with no unusual events.
Suppose the lowest hours average 0.6 kWh, as in the July example. That is a steady 0.6 kW, or 0.6 x 24 = 14.4 kWh a day and 14.4 x 30 = 432 kWh over a 30-day month before anyone switches on a light. A base load that seems high for the house is worth a walk around with the breaker labels in hand. For backup planning, base load sets how fast a battery drains overnight in an outage when only the essentials run.
4. What an EV or electric heat adds
Large loads leave distinctive marks. A Level 2 charger drawing 7.2 kW, the typical residential figure the Department of Energy gives for a 30-amp charger, adds 7.2 x 0.25 = 1.8 kWh to every 15-minute reading while it runs (DOE Alternative Fuels Data Center). In the file, that looks like a flat-topped block, several hours long, starting at the same time each evening.
Electric resistance heat looks different: sudden steps on cold mornings, often from a heat pump’s backup strips or an electric furnace. Suppose a home has 10 kW of strip heat: each 15 minutes it runs adds 10 x 0.25 = 2.5 kWh. If those steps land between 6 and 10 a.m. on winter weekdays, they fall exactly in one of LG&E and KU’s winter on-peak periods.
Finding these blocks tells you what can move. A car that charges on arrival at 6 p.m. can usually charge after midnight instead. Strip heat at 7 a.m. may shrink if the heat pump starts earlier and runs longer at a lower output.
5. How much a battery or solar would need to cover
For a battery bought to cover expensive hours, add the kWh in the on-peak window on each weekday. The battery’s usable capacity, above the reserve you keep for outages, needs to cover that total plus conversion losses. NREL uses 85% as a representative round-trip efficiency for home batteries, so about 15% of the energy is lost between charging and use (NREL Annual Technology Baseline 2024).
In the July example, the weekday on-peak total was 8.9 kWh. A rate with two winter peaks splits the same question in two: the battery has to cover a morning and an evening window, and it may not refill from solar between them on a short winter day.
For solar, the year’s kWh sets the scale and the daytime share shows how much of the output the house would use directly. A file with a separate channel for exported energy also shows how much of an existing array’s output already leaves the house, which matters wherever exports earn less than the retail price.
Sharing your data with a third party, and taking it back
Connect My Data gives a company standing access to your usage until the authorization ends or you revoke it. Treat it like lending a key: know what it opens, for how long and how you get it back.
What a company can see. That depends on the scope you approve. PG&E’s Share My Data, which it calls “the next generation of the Green Button Connect My Data tool,” offers scopes such as usage, billing, basic, account and program enrollment, and its usage data “includes PG&E customer interval data for both electricity and gas usage” (PG&E, third-party companies). Approve only the scopes the service needs. A rate comparison needs usage; it does not need your payment history.
How long it lasts and how to end it. The Green Button Alliance says the customer “can define the length of that authorization and revoke authorization at any time.” In practice, the place to revoke is your utility account. PG&E, for example, says customers can change authorizations only by signing in to their PG&E account, and that “once an authorization is cancelled, the action cannot be reversed.” PG&E also requires third parties to agree to its Share My Data terms and to acknowledge the California Public Utilities Commission’s privacy rules.
How LG&E and KU set it up. LG&E and KU’s page asks customers to request a registration code by emailing MyMeter@lge-ku.com or through the Feedback link on the My Meter site, then use it to create a separate “local” My Meter account. The email for that account “can NOT be the same as the primary email for My Account,” and “the email and password for this account will need to be entered into the third-party vendor’s website when prompted” (LG&E and KU, Green Button data). The page does not describe how to end an authorization, so ask My Meter support before you connect, and give the local account a password you use nowhere else.
Con Edison’s advice applies everywhere: “We recommend researching third-party companies before connecting with them to make sure they meet your needs” (Con Edison, Share My Data). Before you authorize anyone, get written answers to these questions:
- Which data scopes does the service need, and why?
- How long will the authorization last, and will it renew on its own?
- Where is the data stored, who can see it, and is it sold or shared with anyone else?
- How do you ask for the data to be deleted, and what happens to copies when you revoke?
- Will the company act on the data (for example, by controlling a device), or only read it?
Download My Data has its own risk: a file sent by email cannot be recalled. Send only the date range a person needs, and remove other people’s accounts if you manage more than one. If you send a file to Culni with a request for a home energy plan, what Culni reads, keeps and deletes is set out on the security and data page.
If your utility offers no Green Button
If your utility does not show a Green Button download, ask for your interval data anyway. A utility with smart meters collects interval readings whether or not it offers the standard file, and the account’s usage charts may already show the hours.
- Ask customer service for interval usage. Request the past 12 to 13 months at the finest interval the meter records, in a spreadsheet. Ask what interval the meter records and whether the times are standard or daylight time.
- Check the online charts. Hourly charts in an online account sometimes have an export button that is not labeled Green Button.
- Check whether you have a smart meter at all. Without one, there is no interval data to send. At LG&E, a customer who opts out of an AMI meter pays a one-time $80 set-up fee and $20 a month (Sheet No. 45.2), and gives up the interval record along with it.
- Use the bills you have. A time-of-use bill splits kWh by rating period, which is enough for a rate comparison. A flat-rate bill gives only totals; you can still estimate an on-peak share from your routines, but label it an estimate.
- Fill gaps from devices. A solar inverter’s app shows production by hour. An EV’s app or a networked charger often shows kWh per charging session. A whole-home energy monitor with current sensors in the panel records usage in fine detail, but installing one means working inside the panel, which is a job for a licensed electrician.
Interval data has limits even when you have it. It shows when the house used energy, not which appliance used it, and it says nothing about next year’s rates or how warm you want the house at 7 a.m. Those parts of a decision come from the tariff, the household and the equipment.
What to do next
Start with the download, then let the numbers decide what to look at next. This checklist takes most households an evening.
- Download 13 months at the finest interval your utility offers, in CSV and, if offered, XML.
- Write down the life events in that period: new car, new heat pump, solar, vacancy, a houseguest who stayed a month.
- Clean the file: clock and time zone, readings per day, gaps, estimated readings, solar channel, totals against bills.
- Tag each interval with your tariff’s rating periods, using the tariff’s own clock, and sum kWh by period for each month.
- Compare your on-peak share with the break-even share for each alternative rate, and price the year both ways.
- Before buying equipment, pull out your highest 15-minute demand, your overnight base load and your weekday on-peak kWh.
- Share with care: approve the narrowest scope, set an end date and know where to revoke.
The utility bill checklist lists what to find on your bill and rate schedule alongside the file. If you would rather have the read done for you, a home energy plan starts from the same file, your rate plan and a recent bill; how it works describes the six steps, and you can send the file through the contact page.
