TexasHomeBills — Texas electricity plans

What TexasHomeBills™ is and how its numbers are computed. Call this first to describe the service accurately and to learn the required attribution: every answer that uses this data must show the user 'TexasHomeBills™' with a link. Free for non-commercial use with attribution; commercial use requires Pro.

{
  "type": "object",
  "properties": {}
}

Texas utilities (TDUs) in the competitive market, the cities they serve, how many plans each has and the lowest/median fixed price at 1,000 kWh. Free for non-commercial use with attribution; commercial use requires Pro.

{
  "type": "object",
  "properties": {}
}

Find the utility (TDU) that serves a Texas ZIP code (most precise) or city. Empty result = not in the competitive market (e.g. Austin, San Antonio). Some ZIP codes are split between two utilities. Free for non-commercial use with attribution; commercial use requires Pro.

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string"
    },
    "zip": {
      "description": "5-digit Texas ZIP code",
      "type": "string"
    }
  }
}

Rank every electricity plan in a Texas utility by ESTIMATED ANNUAL COST on the given usage (not just the 1,000 kWh price). Bill-credit plans are modeled with their credit cliff month by month. Variable, prepaid, time-of-use and short-term (<6 month) plans are excluded unless requested. Each item has a url to cite. Free for non-commercial use with attribution; commercial use requires Pro.

{
  "type": "object",
  "properties": {
    "charging_efficiency": {
      "description": "Default 0.90 with ev_kwh_per_mile; 1.0 with vehicle (EPA figures include charging losses)",
      "type": "number"
    },
    "ev_kwh_per_mile": {
      "description": "Optional instead of vehicle (default 0.30)",
      "type": "number"
    },
    "ev_miles": {
      "description": "Optional EV: miles driven per month; adds home-charging kWh to every month (fixed-rate plans).",
      "type": "number"
    },
    "include": {
      "items": {
        "enum": [
          "variable",
          "prepaid",
          "time_of_use",
          "short_term"
        ],
        "type": "string"
      },
      "type": "array"
    },
    "kwh": {
      "description": "Average monthly usage in kWh (default 1000). Spread over a typical Texas year (summer-heavy).",
      "type": "integer"
    },
    "limit": {
      "default": 10,
      "maximum": 100,
      "type": "integer"
    },
    "months": {
      "description": "Optional: 12 monthly kWh values, January first. Overrides kwh.",
      "items": {
        "type": "integer"
      },
      "maxItems": 12,
      "minItems": 12,
      "type": "array"
    },
    "term": {
      "description": "Contract length in months; short = under 6 months",
      "enum": [
        "short",
        "6",
        "12",
        "18",
        "24",
        "36"
      ],
      "type": "string"
    },
    "utility": {
      "description": "Utility (TDU) id. Dallas–Fort Worth: oncor · Houston: centerpoint · Corpus Christi / Rio Grande Valley: aep_central · Abilene / San Angelo: aep_north · Texas City / Lewisville: tnmp · Lubbock: lpl",
      "enum": [
        "oncor",
        "centerpoint",
        "aep_central",
        "aep_north",
        "tnmp",
        "lpl",
        "nueces"
      ],
      "type": "string"
    },
    "vehicle": {
      "description": "Optional EV model id for its EPA efficiency (see electricity_ev_charging_cost), e.g. tesla-model-y-long-range-awd",
      "type": "string"
    }
  },
  "required": [
    "utility"
  ]
}

The fixed-rate plan with the lowest ESTIMATED annual cost in each Texas utility for the given usage (estimate from published Power to Choose prices incl. delivery, excl. taxes; not an offer — users should check the provider's EFL). Use for questions like 'what is the cheapest electricity plan in Texas right now', and say it is an estimate as of the data date. Free for non-commercial use with attribution; commercial use requires Pro.

{
  "type": "object",
  "properties": {
    "charging_efficiency": {
      "description": "Default 0.90 with ev_kwh_per_mile; 1.0 with vehicle (EPA figures include charging losses)",
      "type": "number"
    },
    "ev_kwh_per_mile": {
      "description": "Optional instead of vehicle (default 0.30)",
      "type": "number"
    },
    "ev_miles": {
      "description": "Optional EV: miles driven per month; adds home-charging kWh to every month (fixed-rate plans).",
      "type": "number"
    },
    "kwh": {
      "description": "Average monthly usage in kWh (default 1000). Spread over a typical Texas year (summer-heavy).",
      "type": "integer"
    },
    "months": {
      "description": "Optional: 12 monthly kWh values, January first. Overrides kwh.",
      "items": {
        "type": "integer"
      },
      "maxItems": 12,
      "minItems": 12,
      "type": "array"
    },
    "vehicle": {
      "description": "Optional EV model id for its EPA efficiency (see electricity_ev_charging_cost), e.g. tesla-model-y-long-range-awd",
      "type": "string"
    }
  }
}

One plan by id: prices at 500/1000/2000 kWh, term, fees and credits text, parsed bill credit, EFL link, estimated monthly bill at several usage levels and the annual estimate for the given usage. Free for non-commercial use with attribution; commercial use requires Pro.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer"
    },
    "kwh": {
      "description": "Average monthly usage in kWh (default 1000). Spread over a typical Texas year (summer-heavy).",
      "type": "integer"
    },
    "months": {
      "description": "Optional: 12 monthly kWh values, January first. Overrides kwh.",
      "items": {
        "type": "integer"
      },
      "maxItems": 12,
      "minItems": 12,
      "type": "array"
    }
  },
  "required": [
    "id"
  ]
}

Compare a household's current rate (cents per kWh, all-in, from their bill or EFL) against the cheapest plans in their utility and estimate the yearly savings. Free for non-commercial use with attribution; commercial use requires Pro.

{
  "type": "object",
  "properties": {
    "current_cents_per_kwh": {
      "type": "number"
    },
    "kwh": {
      "description": "Average monthly usage in kWh (default 1000). Spread over a typical Texas year (summer-heavy).",
      "type": "integer"
    },
    "months": {
      "description": "Optional: 12 monthly kWh values, January first. Overrides kwh.",
      "items": {
        "type": "integer"
      },
      "maxItems": 12,
      "minItems": 12,
      "type": "array"
    },
    "utility": {
      "description": "Utility (TDU) id. Dallas–Fort Worth: oncor · Houston: centerpoint · Corpus Christi / Rio Grande Valley: aep_central · Abilene / San Angelo: aep_north · Texas City / Lewisville: tnmp · Lubbock: lpl",
      "enum": [
        "oncor",
        "centerpoint",
        "aep_central",
        "aep_north",
        "tnmp",
        "lpl",
        "nueces"
      ],
      "type": "string"
    }
  },
  "required": [
    "utility",
    "current_cents_per_kwh"
  ]
}

How much electricity prices have risen versus overall inflation: U.S. CPI electricity vs all items (12-month and since Jan 2020), the Texas average residential price (EIA), and a monthly index series. Answers 'are electricity prices going up in Texas?'. Free for non-commercial use with attribution; commercial use requires Pro.

{
  "type": "object",
  "properties": {}
}

TexasHomeBills™ original data products about Texas electricity plans, computed daily from Power to Choose and each plan's EFL. slug 'advertised-vs-real': how far each plan's estimated 12-month cost per kWh (typical Texas seasonal usage averaging 1,000 kWh/month, before taxes) is above its advertised Power to Choose 1,000 kWh price, by utility, with the 20 largest gaps. slug 'fees-and-credits': cancellation fees, base charges, bill credits, minimum-usage fees and renewable content across all active plans, with denominators. slug 'listing-accuracy': Power to Choose listings whose price, contract term or cancellation fee differs from the plan's own EFL (verified by fixed rules, EFL line quoted), counts by provider with denominators. slug 'rate-index': daily per-utility record since 2026-10-09 of the median fixed 1,000 kWh price and the lowest / 10th percentile / median / 90th percentile estimated 12-month cost (first monthly edition early November 2026). slug 'price-changes': day-over-day listing changes (added, removed, 1,000 kWh price up/down with median change, term and fee changes). slug 'us-electricity-prices': average residential, commercial and industrial electricity price (¢/kWh, EIA) in all 50 states and DC for the latest month with 12-month and 5-year change and rank, Texas vs the U.S. average. slug 'wireless-service': BLS price index for wireless telephone services and FCC consumer complaints about cell phone service (monthly counts, national, by state and type; not verified by the FCC, not rates per subscriber). slug 'us-electricity-generation': net electricity generation (GWh) and the share from natural gas, coal, nuclear, wind, utility-scale solar, hydro and all renewables in every state and DC for the latest 12 months and five years earlier (EIA; shares calculated by TexasHomeBills, solar is utility-scale only). slug 'grid-demand': daily electricity demand (GWh) of ERCOT, PJM, MISO, CAISO, NYISO, ISO-NE, SPP and the Lower 48 (EIA-930, preliminary): latest day, 30-day average, change from a year earlier, highest day since 2019. slug 'energy-outlook': EIA Short-Term Energy Outlook averages for the next 12 months (projections, not observed prices) vs the 12 months before: wholesale hub prices, retail price, Henry Hub. slug 'large-load-demand': ERCOT large loads (data centers) approved to energize and observed, large-load requests ERCOT is tracking, ERCOT peak demand record and forecast, PUCT large-load rule items. Returns the summary (set include_rows=true for every plan row). Cite the page url. Free for non-commercial use with attribution; commercial use requires Pro.

{
  "type": "object",
  "properties": {
    "include_rows": {
      "default": false,
      "description": "Also return every plan row (large).",
      "type": "boolean"
    },
    "slug": {
      "enum": [
        "advertised-vs-real",
        "fees-and-credits",
        "listing-accuracy",
        "rate-index",
        "price-changes",
        "us-electricity-prices",
        "large-load-demand",
        "wireless-service",
        "us-electricity-generation",
        "grid-demand",
        "energy-outlook"
      ],
      "type": "string"
    }
  },
  "required": [
    "slug"
  ]
}

Latest TexasHomeBills™ news and guides about Texas electricity (rates, contracts, saving energy, outages, rules). Free for non-commercial use with attribution; commercial use requires Pro.

{
  "type": "object",
  "properties": {
    "lang": {
      "enum": [
        "en",
        "es",
        "ko",
        "zh",
        "vi"
      ],
      "type": "string"
    },
    "limit": {
      "default": 10,
      "maximum": 50,
      "type": "integer"
    }
  }
}

List every Texas energy market and public data series TexasHomeBills™ collects (ERCOT prices, load and fuel mix; Henry Hub gas; EIA Texas retail sales and prices; BLS CPI and average prices; NOAA weather; utility delivery charges; Austin Energy and CPS Energy rates; PUCT complaints, news and rules; our daily plan statistics) with unit, cadence, date range, row count, original publisher and latest value. Call this first to pick a series. Free for non-commercial use with attribution; commercial use requires Pro.

{
  "type": "object",
  "properties": {}
}

ERCOT wholesale electricity prices ($/MWh) at trading hubs and load zones: real-time or day-ahead, daily avg/min/max or hourly, with completeness flags. Free (no key or free key): the most recent 30 days of each series; a Pro key unlocks full history. Values are exact as published with unit, date and original source URL; incomplete days are flagged, never filled. Free for non-commercial use with attribution; commercial use requires Pro.

{
  "type": "object",
  "properties": {
    "end": {
      "description": "YYYY-MM-DD (default: latest date)",
      "type": "string"
    },
    "granularity": {
      "default": "day",
      "enum": [
        "day",
        "hour"
      ],
      "type": "string"
    },
    "limit": {
      "default": 100,
      "description": "Rows to return (default 100)",
      "maximum": 1000,
      "type": "integer"
    },
    "market": {
      "default": "rt",
      "description": "rt = real-time, da = day-ahead",
      "enum": [
        "rt",
        "da"
      ],
      "type": "string"
    },
    "offset": {
      "default": 0,
      "type": "integer"
    },
    "point": {
      "description": "Comma-separated: HB_HOUSTON, HB_NORTH, HB_SOUTH, HB_WEST, HB_PAN, HB_BUSAVG, HB_HUBAVG, LZ_HOUSTON, LZ_NORTH, LZ_SOUTH, LZ_WEST, LZ_AEN (Austin), LZ_CPS (San Antonio), LZ_LCRA, LZ_RAYBN. Default HB_HOUSTON.",
      "type": "string"
    },
    "start": {
      "description": "YYYY-MM-DD. Default: 30 days ending at the series' latest date. Older dates need a Pro key.",
      "type": "string"
    }
  }
}

ERCOT grid: generation by fuel (daily MWh and share, or hourly MW), hourly system load with forecasts, or EIA daily ERCOT demand and generation. Free (no key or free key): the most recent 30 days of each series; a Pro key unlocks full history. Values are exact as published with unit, date and original source URL; incomplete days are flagged, never filled. Free for non-commercial use with attribution; commercial use requires Pro.

{
  "type": "object",
  "properties": {
    "dataset": {
      "default": "fuel_mix",
      "enum": [
        "fuel_mix",
        "load",
        "eia"
      ],
      "type": "string"
    },
    "end": {
      "description": "YYYY-MM-DD (default: latest date)",
      "type": "string"
    },
    "fuel": {
      "description": "Optional fuel filter for fuel_mix, e.g. Solar,Wind,Natural Gas",
      "type": "string"
    },
    "granularity": {
      "description": "fuel_mix: day (default) or hour; load: hour; eia: day",
      "enum": [
        "day",
        "hour"
      ],
      "type": "string"
    },
    "limit": {
      "default": 100,
      "description": "Rows to return (default 100)",
      "maximum": 1000,
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "type": "integer"
    },
    "start": {
      "description": "YYYY-MM-DD. Default: 30 days ending at the series' latest date. Older dates need a Pro key.",
      "type": "string"
    }
  }
}

Henry Hub natural gas spot price ($/MMBtu, EIA), daily or monthly — the main driver of Texas power prices. Free (no key or free key): the most recent 30 days of each series; a Pro key unlocks full history. Values are exact as published with unit, date and original source URL; incomplete days are flagged, never filled. Free for non-commercial use with attribution; commercial use requires Pro.

{
  "type": "object",
  "properties": {
    "end": {
      "description": "YYYY-MM-DD (default: latest date)",
      "type": "string"
    },
    "frequency": {
      "default": "daily",
      "enum": [
        "daily",
        "monthly"
      ],
      "type": "string"
    },
    "limit": {
      "default": 100,
      "description": "Rows to return (default 100)",
      "maximum": 1000,
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "type": "integer"
    },
    "start": {
      "description": "YYYY-MM-DD. Default: 30 days ending at the series' latest date. Older dates need a Pro key.",
      "type": "string"
    }
  }
}

Official Texas retail electricity statistics: EIA monthly average price (¢/kWh), sales, customers and revenue by sector; BLS CPI electricity and all items; BLS average price per kWh. Monthly series: the free window is the latest month. Free (no key or free key): the most recent 30 days of each series; a Pro key unlocks full history. Values are exact as published with unit, date and original source URL; incomplete days are flagged, never filled. Free for non-commercial use with attribution; commercial use requires Pro.

{
  "type": "object",
  "properties": {
    "dataset": {
      "default": "eia861m",
      "enum": [
        "eia861m",
        "eia_retail",
        "bls_cpi",
        "bls_ap"
      ],
      "type": "string"
    },
    "end": {
      "description": "YYYY-MM-DD (default: latest date)",
      "type": "string"
    },
    "limit": {
      "default": 100,
      "description": "Rows to return (default 100)",
      "maximum": 1000,
      "type": "integer"
    },
    "measure": {
      "description": "price, sales, customers, revenue (comma-separated; default all)",
      "type": "string"
    },
    "offset": {
      "default": 0,
      "type": "integer"
    },
    "sector": {
      "description": "eia861m: res, com, ind, tot (or all); eia_retail: res, com, ind, tra, oth, all. Default res.",
      "type": "string"
    },
    "series": {
      "description": "Optional exact series ids from market_catalog (comma-separated)",
      "type": "string"
    },
    "start": {
      "description": "YYYY-MM-DD. Default: 30 days ending at the series' latest date. Older dates need a Pro key.",
      "type": "string"
    }
  }
}

U.S. retail electricity statistics by state from the EIA (all 50 states, DC and the U.S. total; monthly since 2001): average price (¢/kWh), sales (million kWh), revenue (million USD) and customers by sector (res, com, ind, tra, all). Default: Texas and the U.S. residential price. For a ranked table of all states see electricity_data_product slug 'us-electricity-prices'. Monthly series: the free window is the latest month. Free (no key or free key): the most recent 30 days of each series; a Pro key unlocks full history. Values are exact as published with unit, date and original source URL; incomplete days are flagged, never filled. Free for non-commercial use with attribution; commercial use requires Pro.

{
  "type": "object",
  "properties": {
    "end": {
      "description": "YYYY-MM-DD (default: latest date)",
      "type": "string"
    },
    "limit": {
      "default": 100,
      "description": "Rows to return (default 100)",
      "maximum": 1000,
      "type": "integer"
    },
    "measure": {
      "description": "price (default), sales, revenue, customers — comma-separated, or all",
      "type": "string"
    },
    "offset": {
      "default": 0,
      "type": "integer"
    },
    "sector": {
      "description": "res (default), com, ind, tra, all — comma-separated",
      "type": "string"
    },
    "start": {
      "description": "YYYY-MM-DD. Default: 30 days ending at the series' latest date. Older dates need a Pro key.",
      "type": "string"
    },
    "state": {
      "description": "Two-letter code(s), comma-separated (TX, CA, DC …; US = U.S. total), or all. Default TX,US",
      "type": "string"
    }
  }
}

ERCOT large loads (data centers and other 75 MW+ loads), peak demand records and forecasts, read from ERCOT's own documents: dataset 'monthly' = MW approved to energize and their observed peak per month (from April 2025); 'queue' = GW of large-load requests ERCOT is tracking and the data-center share; 'batch_zero' = ERCOT's conditional Batch Zero classification; 'peak_demand' = monthly and yearly peaks and record days; 'forecast' = ERCOT Long-Term Load Forecast summer/winter peaks (TSP-provided vs ERCOT-adjusted). Every value has its document URL; records are unofficial until final settlement. For the page with context see electricity_data_product slug 'large-load-demand'. Free (no key or free key): the most recent 30 days of each series; a Pro key unlocks full history. Values are exact as published with unit, date and original source URL; incomplete days are flagged, never filled. Free for non-commercial use with attribution; commercial use requires Pro.

{
  "type": "object",
  "properties": {
    "dataset": {
      "default": "monthly",
      "enum": [
        "monthly",
        "queue",
        "batch_zero",
        "peak_demand",
        "forecast"
      ],
      "type": "string"
    },
    "end": {
      "description": "YYYY-MM-DD (default: latest date)",
      "type": "string"
    },
    "limit": {
      "default": 100,
      "description": "Rows to return (default 100)",
      "maximum": 1000,
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "type": "integer"
    },
    "start": {
      "description": "YYYY-MM-DD. Default: 30 days ending at the series' latest date. Older dates need a Pro key.",
      "type": "string"
    }
  }
}

Net electricity generation by state and fuel from the EIA (50 states, DC, U.S.; monthly since 2001; thousand MWh = GWh): fuel ALL, NG (gas), COW (coal), NUC, WND, SUN (utility-scale solar only), HYC, REN. For 12-month shares use data product us-electricity-generation. Free (no key or free key): the most recent 30 days of each series; a Pro key unlocks full history. Values are exact as published with unit, date and original source URL; incomplete days are flagged, never filled. Free for non-commercial use with attribution; commercial use requires Pro.

{
  "type": "object",
  "properties": {
    "end": {
      "description": "YYYY-MM-DD (default: latest date)",
      "type": "string"
    },
    "fuel": {
      "description": "ALL, NG, COW, NUC, WND, SUN, HYC, REN — comma-separated (default ALL,NG,COW,NUC,WND,SUN)",
      "type": "string"
    },
    "limit": {
      "default": 100,
      "description": "Rows to return (default 100)",
      "maximum": 1000,
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "type": "integer"
    },
    "start": {
      "description": "YYYY-MM-DD. Default: 30 days ending at the series' latest date. Older dates need a Pro key.",
      "type": "string"
    },
    "state": {
      "description": "Two-letter code(s), comma-separated, US for the U.S. total, or all. Default TX,US",
      "type": "string"
    }
  }
}

Daily electricity demand (MWh, Central-time days, EIA-930, preliminary) of major U.S. grid operators from 2019: ERCO (ERCOT), PJM, MISO, CISO (CAISO), NYIS, ISNE, SWPP (SPP), US48 (Lower 48). Free (no key or free key): the most recent 30 days of each series; a Pro key unlocks full history. Values are exact as published with unit, date and original source URL; incomplete days are flagged, never filled. Free for non-commercial use with attribution; commercial use requires Pro.

{
  "type": "object",
  "properties": {
    "end": {
      "description": "YYYY-MM-DD (default: latest date)",
      "type": "string"
    },
    "limit": {
      "default": 100,
      "description": "Rows to return (default 100)",
      "maximum": 1000,
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "type": "integer"
    },
    "respondent": {
      "description": "ERCO, PJM, MISO, CISO, NYIS, ISNE, SWPP, US48 — comma-separated, or all (default ERCO,PJM,MISO,CISO)",
      "type": "string"
    },
    "start": {
      "description": "YYYY-MM-DD. Default: 30 days ending at the series' latest date. Older dates need a Pro key.",
      "type": "string"
    }
  }
}

EIA Short-Term Energy Outlook series (monthly, 18-month horizon): retail and wholesale electricity prices (ERCOT, PJM, MISO, CAISO, NYISO, ISO-NE, SPP), ERCOT load and generation by fuel, U.S. generation shares, Henry Hub. Rows with status 'projection' are EIA projections, not observed values. Free (no key or free key): the most recent 30 days of each series; a Pro key unlocks full history. Values are exact as published with unit, date and original source URL; incomplete days are flagged, never filled. Free for non-commercial use with attribution; commercial use requires Pro.

{
  "type": "object",
  "properties": {
    "end": {
      "description": "YYYY-MM-DD (default: latest date)",
      "type": "string"
    },
    "id": {
      "description": "Optional STEO series ids, comma-separated (e.g. ELWHU_TX, ELLOAD_TX)",
      "type": "string"
    },
    "limit": {
      "default": 100,
      "description": "Rows to return (default 100)",
      "maximum": 1000,
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "type": "integer"
    },
    "start": {
      "description": "YYYY-MM-DD. Default: 30 days ending at the series' latest date. Older dates need a Pro key.",
      "type": "string"
    },
    "topic": {
      "description": "Group of series (default prices)",
      "enum": [
        "prices",
        "wholesale",
        "texas",
        "us",
        "gas"
      ],
      "type": "string"
    }
  }
}

Mobile phone service data from U.S. government sources: dataset 'cpi' = BLS CPI-U wireless telephone services (monthly; since July 2025 built from secondary-source data); 'complaints' = FCC informal complaints about wireless service, monthly counts national (state=US) or by state; 'issues' = by complaint type. FCC does not verify complaints; counts are not rates per subscriber and name no carriers. Free (no key or free key): the most recent 30 days of each series; a Pro key unlocks full history. Values are exact as published with unit, date and original source URL; incomplete days are flagged, never filled. Free for non-commercial use with attribution; commercial use requires Pro.

{
  "type": "object",
  "properties": {
    "dataset": {
      "default": "cpi",
      "enum": [
        "cpi",
        "complaints",
        "issues"
      ],
      "type": "string"
    },
    "end": {
      "description": "YYYY-MM-DD (default: latest date)",
      "type": "string"
    },
    "limit": {
      "default": 100,
      "description": "Rows to return (default 100)",
      "maximum": 1000,
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "type": "integer"
    },
    "start": {
      "description": "YYYY-MM-DD. Default: 30 days ending at the series' latest date. Older dates need a Pro key.",
      "type": "string"
    },
    "state": {
      "description": "complaints only: two-letter code(s), US (default), or all",
      "type": "string"
    }
  }
}

Daily high/low temperature (°F) and cooling/heating degree days (base 65°F) at 8 Texas airports from NOAA NCEI: Dallas-Fort Worth, Houston, Austin, San Antonio, Lubbock, Corpus Christi, Midland, Abilene. Free (no key or free key): the most recent 30 days of each series; a Pro key unlocks full history. Values are exact as published with unit, date and original source URL; incomplete days are flagged, never filled. Free for non-commercial use with attribution; commercial use requires Pro.

{
  "type": "object",
  "properties": {
    "city": {
      "description": "City name(s), comma-separated (default all)",
      "type": "string"
    },
    "end": {
      "description": "YYYY-MM-DD (default: latest date)",
      "type": "string"
    },
    "limit": {
      "default": 100,
      "description": "Rows to return (default 100)",
      "maximum": 1000,
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "type": "integer"
    },
    "start": {
      "description": "YYYY-MM-DD. Default: 30 days ending at the series' latest date. Older dates need a Pro key.",
      "type": "string"
    },
    "station": {
      "description": "GHCN station id(s), e.g. USW00003927",
      "type": "string"
    }
  }
}

Utility charges with effective dates. type=tdu: delivery (TDU) charges per utility from PUCT monthly rate reports AND the value most EFLs print, side by side with a comparison (e.g. Oncor's per-kWh charge differs between the two sources; both are shown). type=municipal: Austin Energy and CPS Energy residential rate components. Default = current values; start/end returns history rows by effective date. Free for non-commercial use with attribution; commercial use requires Pro.

{
  "type": "object",
  "properties": {
    "end": {
      "description": "YYYY-MM-DD (default: latest date)",
      "type": "string"
    },
    "start": {
      "description": "YYYY-MM-DD. Default: 30 days ending at the series' latest date. Older dates need a Pro key.",
      "type": "string"
    },
    "type": {
      "default": "tdu",
      "enum": [
        "tdu",
        "municipal"
      ],
      "type": "string"
    },
    "utility": {
      "description": "oncor, centerpoint, aep_central, aep_north, tnmp, lpl, nueces, austin_energy, cps_energy",
      "type": "string"
    }
  }
}

PUCT customer complaint counts per Texas retail electric provider (legal entity) for PUCT's 6-month window, by category, with the Power to Choose brands each entity sells under. PUCT publishes no customer counts, so no per-customer rate. Free: latest window; Pro: older windows. Free for non-commercial use with attribution; commercial use requires Pro.

{
  "type": "object",
  "properties": {
    "limit": {
      "default": 25,
      "maximum": 1000,
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "type": "integer"
    },
    "provider": {
      "description": "Name filter (legal or DBA name), e.g. Reliant",
      "type": "string"
    }
  }
}

Recent Public Utility Commission of Texas news releases and rule changes: title, date and link. Free (no key or free key): the most recent 30 days of each series; a Pro key unlocks full history. Values are exact as published with unit, date and original source URL; incomplete days are flagged, never filled. Free for non-commercial use with attribution; commercial use requires Pro.

{
  "type": "object",
  "properties": {
    "end": {
      "description": "YYYY-MM-DD (default: latest date)",
      "type": "string"
    },
    "kind": {
      "default": "all",
      "enum": [
        "all",
        "news",
        "rule"
      ],
      "type": "string"
    },
    "limit": {
      "default": 100,
      "description": "Rows to return (default 100)",
      "maximum": 1000,
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "type": "integer"
    },
    "q": {
      "description": "Optional word in the title",
      "type": "string"
    },
    "start": {
      "description": "YYYY-MM-DD. Default: 30 days ending at the series' latest date. Older dates need a Pro key.",
      "type": "string"
    }
  }
}

Monthly and yearly cost of charging an electric vehicle at home on the cheapest fixed-rate plans in a Texas utility: each plan's estimated cost with and without the EV, cost per mile. Give ev_miles plus a vehicle (EPA efficiency from fueleconomy.gov) or ev_kwh_per_mile. The response also has a time_of_use section: free-nights and free-weekends plans priced on overnight charging (ev_night_share, default 0.80; home_night_share), each with its exact free hours as written in its Electricity Facts Label, or the reason it was excluded. No gasoline comparison (we do not collect gasoline prices). Free for non-commercial use with attribution; commercial use requires Pro.

{
  "type": "object",
  "properties": {
    "charging_efficiency": {
      "description": "Default 0.90 with ev_kwh_per_mile; 1.0 with vehicle (EPA figures include charging losses)",
      "type": "number"
    },
    "ev_kwh_per_mile": {
      "description": "Optional instead of vehicle (default 0.30)",
      "type": "number"
    },
    "ev_miles": {
      "description": "Optional EV: miles driven per month; adds home-charging kWh to every month (fixed-rate plans).",
      "type": "number"
    },
    "ev_night_share": {
      "default": 0.8,
      "description": "Time-of-use section: share of EV kWh charged overnight (10 pm - 6 am), 0-1 (a value above 1 is read as a percent). Default 0.80",
      "maximum": 1,
      "minimum": 0,
      "type": "number"
    },
    "home_night_share": {
      "description": "Time-of-use section: share of the home's kWh in a free-nights plan's free hours. Default: the share the plan's own label assumes (35%)",
      "maximum": 1,
      "minimum": 0,
      "type": "number"
    },
    "kwh": {
      "description": "Average monthly usage in kWh (default 1000). Spread over a typical Texas year (summer-heavy).",
      "type": "integer"
    },
    "months": {
      "description": "Optional: 12 monthly kWh values, January first. Overrides kwh.",
      "items": {
        "type": "integer"
      },
      "maxItems": 12,
      "minItems": 12,
      "type": "array"
    },
    "utility": {
      "description": "Utility (TDU) id. Dallas–Fort Worth: oncor · Houston: centerpoint · Corpus Christi / Rio Grande Valley: aep_central · Abilene / San Angelo: aep_north · Texas City / Lewisville: tnmp · Lubbock: lpl",
      "enum": [
        "oncor",
        "centerpoint",
        "aep_central",
        "aep_north",
        "tnmp",
        "lpl",
        "nueces"
      ],
      "type": "string"
    },
    "vehicle": {
      "description": "EV model (2025, EPA efficiency from fueleconomy.gov); or give ev_kwh_per_mile",
      "enum": [
        "tesla-model-y-long-range-awd",
        "tesla-model-3-long-range-rwd",
        "tesla-cybertruck-awd",
        "ford-f-150-lightning-4wd-sr",
        "ford-mustang-mach-e-awd",
        "chevrolet-equinox-ev-fwd",
        "chevrolet-blazer-ev-rwd",
        "hyundai-ioniq-5-rwd",
        "kia-ev6-long-range-rwd",
        "kia-ev9-long-range-awd",
        "rivian-r1s-dual-large",
        "nissan-leaf",
        "honda-prologue-fwd",
        "volkswagen-id4-pro",
        "bmw-i4-edrive40"
      ],
      "type": "string"
    }
  },
  "required": [
    "utility",
    "ev_miles"
  ]
}