Cali-GrafCali-Graf
ReferenceUsage dataSCEGreen ButtonDesign

Green Button interval data: how to pull it and use it in design

Cali-Graf · Published Nov 18, 2026 · Data as of Nov 18, 2026

Green Button is the standard way a California utility customer gets the hourly readings of their own meter. An SCE customer downloads them in My Account, under Data Sharing & Download, then Green Button Download My Data, as 15- or 60-minute intervals depending on the meter; or authorizes an installer to receive them automatically through Green Button Connect. For a solar design under net billing, the hours matter as much as the total: in our model, 30 homes that each use exactly 9,000 kWh a year save from $1,242 to $1,653 a year with the same 5.49 kW of solar, because they use power at different hours. A design from the yearly total alone gives the middle, $1,360.

$411
Spread of yearly solar saving between homes of the same yearly use
Same system, modeled homes
47%
Highest share of solar used in the home among them
No battery
360
Days of interval data Cali-Graf needs for a full year
Otherwise bills are used
In this guide
Getting the data from SCEWhat the file holdsUsing it in a designData limitsQuestionsMethodologySourcesHow to cite this page

Getting the data from SCE#

- Download My Data. The customer signs in to My Account on sce.com and, on the left side of the page, selects Data Sharing & Download, then Green Button Download My Data. SCE says interval data comes in 15- or 60-minute intervals, depending on the meter. For a design, download the last twelve months. - Connect My Data. SCE's Green Button Connect sends a customer's data securely and automatically to a third party such as a solar company, once the customer authorizes it. The company has to register with SCE first, with its Taxpayer Identification Number, agree to SCE's terms and pass a connectivity test; its system must handle customer authorization with OAuth 2.0 and files sent through a bulk API. - Signed authorization. Without Green Button Connect, an installer can request the data with SCE's Customer Information Service Request form 14-796, filled in by the customer and the installer, and a written request naming the account and the data wanted; SCE charges fees for it under Schedule CISR-SF.

Upload the customer's Green Button file
Cali-Graf reads SCE's XML and CSV files, bills the home on its own hours before and after solar, and builds the customer proposal.
Open Cali-Graf

What the file holds#

Green Button files come in two forms.

- XML. This file follows the NAESB Energy Services Provider Interface standard (REQ.21). Each reading has a start time, in seconds since 1970 in UTC, a duration in seconds and a value. The reading type gives the unit (code 72 is watt-hours) and a power-of-ten multiplier. It also gives the direction: 1 is energy delivered to the home, 19 is energy sent back to the grid. - CSV. In the SCE files we have read, readings are listed as "start to end" periods in local clock time. Energy delivered and energy received are in separate sections.

A home with solar has both channels, delivered and received. Its delivered channel is what the home took from the grid after its own solar, not what the home used. A file from such a home cannot be read as the home's use without adding back the solar output. This matters most when adding a battery or more panels to an existing system.

Using it in a design#

HomeSolar used in the homeBill without solarSolar saves a year
Lowest saving30%$3,598$1,242
Lower quarter32%$3,542$1,285
Middle35%$3,442$1,358
Upper quarter36%$3,582$1,386
Highest saving47%$3,447$1,653
Yearly use only35%$3,537$1,360

30 modeled homes (NLR ResStock, SCE baseline region 9), each scaled to exactly 9,000 kWh a year and entered into the Cali-Graf engine as a year of hourly Green Button data, with the same 5.49 kW of south-facing solar at ZIP 91790. Bills for 2027 at SCE's rates of October 1, 2026: TOU-D-4-9PM without solar, the Net Billing Tariff on TOU-D-PRIME with it. Rows are the homes with the lowest saving, at the quarters and the highest; "yearly use only" is the same engine given 9,000 kWh and no hours. Source: Cali-Graf engine.

Download this table (CSV)

Under net billing, a kWh of solar used in the home saves the retail price of its hour, and an exported kWh earns a few cents. So the saving follows the share of solar the home uses itself, from 30% to 47% in these homes, and a design that knows only the yearly total can be off by hundreds of dollars a year for one home. Eight of every ten homes fell between $1,248 and $1,451. Real homes differ in more than this model shows: an electric vehicle or a pool pump moves use from one hour to another.

How Cali-Graf reads the file:

- Time. Readings are converted to Pacific Standard Time all year, like the weather and solar data, so every hour appears once: the hour that repeats on the clock when daylight saving ends becomes two separate hours, and the hour the clock skips in spring leaves no gap. 15-minute readings are added up into hours. - A full year. A file is used as the home's year only if it covers at least 360 days with no more than 5 days of missing hours; otherwise the design uses bills or the yearly use. A day with up to 4 missing hours is filled in by interpolation. - The design year. Each day of the design year takes the same day of the file's year, moved to the same weekday, so weekdays stay weekdays. - Solar homes. A file with energy sent back to the grid is flagged, for the reason above.

Data limits#

The homes are modeled, not real customers, and each is scaled to exactly the same yearly use so that only the hours differ. The SCE menu path and the Green Button Connect requirements are those on SCE's pages on November 18, 2026; SCE can change them. Other utilities offer Green Button too, with their own menus and file layouts.

How do I download Green Button data from SCE?

Sign in to My Account on sce.com, choose Data Sharing & Download on the left side of the page, then Green Button Download My Data. The data comes in 15- or 60-minute intervals, depending on the meter.

Can an installer get a customer's SCE usage data directly?

Yes, through Green Button Connect, once the customer authorizes it in My Account. The installer must first register with SCE as a third party and pass a connectivity test.

Why use interval data instead of bills for a solar design?

Bills give the monthly total; interval data shows the hours. Under net billing the hours decide how much of the solar the home uses itself. In our model, homes with the same 9,000 kWh a year saved from $1,242 to $1,653 with the same system.

Methodology#

The SCE steps and the Green Button Connect requirements are quoted from SCE's pages (personal information request, Energy Management Center, Access Energy Usage Data for Partners, Green Button Third Party Connection), saved on November 18, 2026. The XML codes are those of the Green Button Alliance's pages and PG&E's guide to Green Button data elements. File handling is that of the Cali-Graf engine. Example: 30 NLR ResStock homes of SCE baseline region 9, each scaled to 9,000 kWh for 2025, given to the engine as hourly data; solar 5.49 kW south at 20°, typical-year weather at ZIP 91790; bills for 2027 at SCE's rates of October 1, 2026, SCE generation, no city tax. Amounts are rounded half up.

Sources#

  1. Southern California Edison — Personal information request (Green Button Download My Data). https://www.sce.com/california-consumer-privacy-act-information-request
  2. Southern California Edison — Energy Management Center. https://www.sce.com/clean-energy-efficiency/home/energy-management-center
  3. Southern California Edison — Access Energy Usage Data for Partners (Green Button Connect). https://www.sce.com/partners/3rd-party-energy-providers/access-energy-usage-data
  4. Southern California Edison — Green Button Third Party Connection. https://www.sce.com/partners/partnerships/thirdpartylandingpage
  5. Green Button Alliance — Cost and currency representation; Power of ten multiplier. https://greenbuttonalliance.org/costandcurrency
  6. Pacific Gas and Electric — Supported data elements, ESPI-derived Share My Data. https://www.pge.com/assets/pge/docs/save-energy-and-money/energy-savings-programs/Supported-Data-Elements-espiDerived-SMD-Click-Thru-1.0.pdf
  7. NLR — ResStock 2025 Release 1. https://registry.opendata.aws/nrel-pds-building-stock/

How to cite this page#

Cali-Graf. “Green Button interval data: how to pull it and use it in design.” cali-graf.com, updated Nov 18, 2026. https://cali-graf.com/guides/green-button-interval-data-solar-design/