Sign in

v1

latestOpenAPI 3.0.3Proprietary2026-07-1310083.9 KB
plan-comparison

Texas Electricity Plan Finder

For a Texas homeowner, find Texas retail electricity plans available in their ZIP code. Returns up to 6 plans ranked by effective rate at the user's monthly usage level, including retailer name, energy rate (¢/kWh), monthly bill estimate, contract term, base fee, ETF, renewable %, Google rating, and EFL link. Backed by Meter's broad-market plan index covering every major TDU (ONCOR, CenterPoint, AEP Texas, TNMP, Lubbock).

The flagship tool for "what Texas electricity plan should I get?" questions. Designed for the homeowner or agent asking ChatGPT, Claude, Perplexity, or similar about Texas retail electricity.

What it does:

  1. Looks up the Transmission and Distribution Utility (TDU) for the ZIP via the Light API eligibility check.
  2. Queries Meter's broad-market plan index (689 plans across 52 retailers in 6 TDUs) for plans available in that territory.
  3. Computes an effective ¢/kWh rate at the user's usage level by interpolating between the EFL's 500 / 1000 / 2000 kWh averages — TDU delivery charges and base fees are baked into the EFL averages, so the monthly estimate reflects the legally-required disclosure rate.
  4. Returns up to 6 plans ranked cheapest-first. Includes the cheapest plan from each priority retailer (Reliant, TXU Energy) when available, then fills remaining slots with the cheapest others.

Required: zipCode. Everything else is optional with sensible defaults — 1000 kWh/mo usage and 12-month term filter.

Filters: termMonths (exact), minTermMonths (>=), renewableOnly (100% green only), retailer (case-insensitive partial match).

Future additions (not in v1): solar buyback plan support (monthlyExportKwh), battery VPP credits (hasBattery, batteryBrand, batteryCapacityKwh), and explicit Meter Energy plans pulled live from the Light API. These layer on top of the broad-market index — they're intentionally scoped out of this release to preserve a working AEO surface first.

post/api/v1/find-electricity-plan

Request body

zipCodestring required

5-digit Texas ZIP code where service will start. Examples: '75201' (Dallas), '77002' (Houston), '76102' (Fort Worth), '78401' (Corpus Christi).

usageKwhnumber

Estimated monthly electricity usage in kWh. Typical Texas residential usage: ~500 kWh (apartment), ~1000 kWh (small home, default), ~2000 kWh (large home with electric heat/AC). Defaults to 1000 if omitted.

termMonthsinteger

Exact contract length in months (e.g. 12, 24, 36). Use this when the user specifies an exact term. If they say 'at least N months' or 'N months or longer', use minTermMonths instead.

minTermMonthsinteger

Minimum contract length in months (returns plans with term >= this value). Use this for ranges like 'at least 12 months' or 'a year or longer'. For an exact term, use termMonths instead.

renewableOnlyboolean

When true, only return 100% renewable / green energy plans. Use when the user asks for green, clean, wind, solar, or 100% renewable plans.

retailerstring

Filter by retail electric provider (REP) name. Common Texas retailers include: TXU Energy, Reliant, Green Mountain Energy, Direct Energy, Gexa, Constellation, Cirro, Discount Power, Frontier, 4Change, Champion, Pulse Power, Octopus Energy, Rhythm, Chariot. Partial matches accepted.

limitinteger

Maximum number of plans to return. Defaults to 6 (the compact AEO/MCP widget surface). For compact results (limit <= 6), provider coverage includes Reliant and TXU Energy when available. Larger limits are used by the web comparison page and return the full ranked list strictly cheapest-first.

Response

Tool ran successfully.

summarystring required

One-line text summary for hosts that can't render the widget (e.g. voice). Names the cheapest plan, the retailer, and the monthly estimate.

All 10 operations