Meta Pixel

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: | Profile | Customer type | |---|---| | RESHIWR | Residential heating with weather response (default — most common) | | RESHIDG | Residential heating with distributed generation (solar homes) | | RESHIPV | Residential heating with PV | | RESHIWD | Residential 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."

Endpoint

POST https://meterplan.com/api/v1/get-residential-load-profile

MCP tool name: get_residential_load_profile

Inputs

  • zipCodestring

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

  • weatherZoneenum<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.

  • profileTypeenum<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.

  • yearnumber

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

  • granularityenum<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.

Outputs

  • resolvedWeatherZonestring

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

  • profileTypestring

    ERCOT residential profile type used.

  • yearnumber

    Profile year used.

  • granularitystring

    Granularity flag echoed back.

  • annualTotalKwhnumber

    Total annual kWh for the typical home in this zone.

  • peakHourlyKwnumber

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

  • monthlyTotalsKwharray<number>

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

  • intervalsany

    The actual data, shape depends on granularity. monthly_hourly = 288 entries; monthly_totals = 12 entries; annual_hourly = 8760 entries.

  • sourceobject

    Metadata about the data source.

Example prompts

  • “Get the typical residential load profile for Houston (zone COAST).”
  • “What does a typical home in DFW use by hour of the day?”
  • “ERCOT residential load curve for ZIP 78704.”
  • “Annual hourly load profile for the South weather zone with solar PV.”
  • “Monthly total kWh for a typical residential home in West Texas.”