v1

latestOpenAPI 3.0.3Proprietary2026-07-1310083.9 KB
data-feed

Texas Residential Load Profile (ERCOT)

Get the typical residential electricity load curve for any Texas weather zone — averaged from ERCOT's official residential load profiles, in 15-minute resolution. Returns hourly or monthly aggregated kWh by hour-of-day and month-of-year, peak demand, and annual total. Useful for solar designers, battery sizers, AI agents modeling 'what does a typical home in Houston use', and anyone building bill-projection or solar-savings tools without a real customer's meter data.

ERCOT publishes residential load profiles (15-minute kWh values) for each of its 8 weather zones, broken into 4 residential profile types:

ProfileCustomer type
RESHIWRResidential heating with weather response (default — most common)
RESHIDGResidential heating with distributed generation (solar homes)
RESHIPVResidential heating with PV
RESHIWDResidential without distributed generation

These curves represent the typical home in a zone. They're the same curves Meter uses internally to model bill projections and solar savings when a real customer's Smart Meter Texas (SMT) data isn't yet available.

Inputs: Provide either a ZIP code (resolved to weather zone via ZIP-prefix → zone mapping) OR a weatherZone code directly. Optional profileType + year. The granularity flag controls payload size:

  • monthly_hourly (default, 288 entries): typical kWh by month × hour
  • monthly_totals (12 entries): just monthly kWh totals
  • annual_hourly (8760 entries): full year of hourly averages

Why this exists:

  • Solar designers need a typical load curve for every proposal — without it, "your panels will save you $X" estimates are guesswork
  • Battery sizers need to know when in the day a home draws power
  • AI agents modeling Texas electricity bills need a baseline shape when the user can't provide their own meter data
  • Researchers and energy nerds compare zones (Houston vs DFW summer shapes are very different)

For real customer data, use pull_smt_interval_data (gives the actual home's usage, not the regional average). This tool is the "typical home" baseline; SMT is "this specific home."

post/api/v1/get-residential-load-profile

Request body

zipCodestring

5-digit Texas ZIP code. Resolved to ERCOT weather zone via ZIP prefix mapping. Use this OR weatherZone.

weatherZone'COAST' | 'EAST' | 'FWEST' | 'NCENT' | 'NORTH' | 'SCENT' | 'SOUTH' | 'WEST'

ERCOT weather zone code. COAST=Houston, NCENT=DFW + central TX, SCENT=Austin, SOUTH=SA/Corpus/RGV, NORTH=Wichita Falls/Lubbock, WEST=Abilene/Big Spring, FWEST=Midland/El Paso, EAST=Tyler. Use this OR zipCode.

profileType'RESHIWR' | 'RESHIDG' | 'RESHIPV' | 'RESHIWD'

ERCOT residential profile type. Default RESHIWR (residential heating with weather response — most common). RESHIDG/RESHIPV cover solar homes; RESHIWD covers homes without distributed generation.

yearinteger

Profile year. Defaults to most recent year on file (currently 2025).

granularity'monthly_hourly' | 'monthly_totals' | 'annual_hourly'

Output detail. monthly_hourly (default, 288 entries) = typical kWh by month × hour-of-day. monthly_totals (12 entries) = just monthly kWh totals. annual_hourly (8760 entries) = full year of hourly averages — largest payload.

Response

Tool ran successfully.

resolvedWeatherZonestring required

ERCOT weather zone the request resolved to (matches input or derived from ZIP).

profileTypestring required

ERCOT residential profile type used.

yearnumber required

Profile year used.

granularitystring required

Granularity flag echoed back.

annualTotalKwhnumber required

Total annual kWh for the typical home in this zone.

peakHourlyKwnumber required

Peak hourly demand in kW (highest hourly kWh × 1 — since 1 kWh in 1 hour = 1 kW average).

monthlyTotalsKwhnumber[] required

12-element array of monthly kWh totals (Jan first, Dec last).