Search skmtc…
⌘K
Docs
Sign in
APIs
Generators
Stacks
Projects
Docs
History
Schema
Generate
Filter operations
get
/
API index: endpoint list, MCP URL, data source and refresh time
get
/bulk/plans.csv
Legacy path, still supported: same as GET /electricity/bulk/plans.csv. Pro: every active plan as CSV, refreshed daily
get
/bulk/plans.json
Legacy path, still supported: same as GET /electricity/bulk/plans.json. Pro: every active plan as JSON, refreshed daily
get
/bulk/{series}.csv
Pro: full history of one series as CSV (streamed). Optional start/end.
get
/cheapest
Legacy path, still supported: same as GET /electricity/cheapest. Fixed-rate plan with the lowest estimated annual cost in each utility (estimate, not an offer)
get
/data
Legacy path, still supported: same as GET /electricity/data. TexasHomeBills original data products (page, CSV and JSON URLs, headline numbers)
get
/data/{slug}
Legacy path, still supported: same as GET /electricity/data/{slug}. One data product with summary tables and every row: advertised-vs-real (advertised 1,000 kWh price vs estimated 12-month cost per kWh), fees-and-credits (cancellation fees, base charges, bill credits, minimum-usage fees, renewable content), listing-accuracy (Power to Choose listings vs each plan's EFL, verified differences with the EFL line quoted), rate-index (daily per-utility median price and 12-month cost distribution since 2026-10-09) price-changes (day-over-day listing changes), us-electricity-prices (EIA average residential/commercial/industrial price in every state and DC, latest month, 12-month and 5-year change, rank) large-load-demand (ERCOT large loads, peak demand record and forecast, PUCT large-load rule items), us-electricity-generation (net generation and 12-month shares of gas, coal, nuclear, wind, utility-scale solar, hydro by state, EIA), wireless-service (BLS CPI wireless telephone services and FCC cell-phone complaint counts), grid-demand (daily demand of ERCOT, PJM, MISO, CAISO, NYISO, ISO-NE, SPP; EIA-930), energy-outlook (EIA STEO projections for the next 12 months vs the 12 months before; projections, not observed prices) or ai-visibility (requests by AI crawlers and agents recorded by our server, by AI brand, with verification stated)
get
/electricity/bulk/plans.csv
Pro: every active plan as CSV, refreshed daily
get
/electricity/bulk/plans.json
Pro: every active plan as JSON, refreshed daily
get
/electricity/cheapest
Fixed-rate plan with the lowest estimated annual cost in each utility (estimate, not an offer)
get
/electricity/data
TexasHomeBills original data products (page, CSV and JSON URLs, headline numbers)
get
/electricity/data/{slug}
One data product with summary tables and every row: advertised-vs-real (advertised 1,000 kWh price vs estimated 12-month cost per kWh), fees-and-credits (cancellation fees, base charges, bill credits, minimum-usage fees, renewable content), listing-accuracy (Power to Choose listings vs each plan's EFL, verified differences with the EFL line quoted), rate-index (daily per-utility median price and 12-month cost distribution since 2026-10-09) price-changes (day-over-day listing changes), us-electricity-prices (EIA average residential/commercial/industrial price in every state and DC, latest month, 12-month and 5-year change, rank) large-load-demand (ERCOT large loads, peak demand record and forecast, PUCT large-load rule items), us-electricity-generation (net generation and 12-month shares of gas, coal, nuclear, wind, utility-scale solar, hydro by state, EIA), wireless-service (BLS CPI wireless telephone services and FCC cell-phone complaint counts), grid-demand (daily demand of ERCOT, PJM, MISO, CAISO, NYISO, ISO-NE, SPP; EIA-930), energy-outlook (EIA STEO projections for the next 12 months vs the 12 months before; projections, not observed prices) or ai-visibility (requests by AI crawlers and agents recorded by our server, by AI brand, with verification stated)
get
/electricity/ev-charging-cost
Home EV charging cost on the cheapest fixed-rate plans in a utility: each plan's estimated 12-month cost with and without the EV, per month and per mile. The response also has a time_of_use section: free-nights and free-weekends plans priced on overnight charging, with each plan's exact free hours as written in its EFL, or the reason it was excluded. No gasoline comparison.
get
/electricity/history/plan/{id}
Pro: one plan day by day, with its EFL versions
get
/electricity/history/plans
Pro: every listing recorded on one day (daily history since 2026-10-09)
get
/electricity/news
Guides and news
get
/electricity/plans
Active plans (paged)
get
/electricity/plans/{id}
One plan with prices, fees, credit and monthly bill estimates
get
/electricity/providers
PUCT-certified retail electric providers
get
/electricity/rank
Rank plans in a utility by estimated annual cost for a usage
get
/electricity/trends
Electricity prices vs inflation: BLS CPI electricity and all items, EIA Texas residential price, monthly index (2020-01 = 100)
get
/electricity/utilities
Texas utilities (TDUs), cities, plan counts, lowest/median fixed price
get
/electricity/vehicles
EV models accepted by vehicle=, with EPA combined kWh/100 mi and the fueleconomy.gov source link
get
/electricity/zip/{zip}
Utility (TDU) serving a Texas ZIP code; empty = not in the competitive market
get
/history/plan/{id}
Legacy path, still supported: same as GET /electricity/history/plan/{id}. Pro: one plan day by day, with its EFL versions
get
/history/plans
Legacy path, still supported: same as GET /electricity/history/plans. Pro: every listing recorded on one day (daily history since 2026-10-09)
get
/internet
Planned domain (home internet): always 404 with status=planned
get
/internet/{path}
Planned domain (home internet): no endpoints yet; always 404 with status=planned
get
/market
Catalog of every market and public data series: description, unit, cadence, date range, row count, source, terms, free window, latest value
get
/market/complaints
PUCT complaint counts per retail electric provider (legal entity) by category for PUCT's 6-month window, with linked Power to Choose brands. Default latest window; window=all or start/end (by window end) for older windows (Pro).
get
/market/delivery-charges
TDU delivery charges: PUCT monthly report values and EFL consensus side by side with a comparison (differences shown, not resolved). Default current values; start/end/history=1 returns history rows by effective date.
get
/market/gas
Henry Hub natural gas spot price (USD/MMBtu, EIA). Every row carries its unit, date and original source_url; incomplete days are flagged (complete=false), never filled. Response has `attribution` (TexasHomeBills™ + link) and `sources` (original publishers with URLs and terms).
get
/market/generation
EIA net electricity generation by state and fuel (gas, coal, nuclear, wind, utility-scale solar, hydro, renewables), monthly since 2001, GWh. Solar is utility-scale only. Every row carries its unit, date and original source_url; incomplete days are flagged (complete=false), never filled. Response has `attribution` (TexasHomeBills™ + link) and `sources` (original publishers with URLs and terms).
get
/market/grid
ERCOT fuel mix (daily MWh and share, hourly MW), hourly system load with forecasts, or EIA daily ERCOT demand/generation. Every row carries its unit, date and original source_url; incomplete days are flagged (complete=false), never filled. Response has `attribution` (TexasHomeBills™ + link) and `sources` (original publishers with URLs and terms).
get
/market/large-load
ERCOT large loads (data centers), peak demand records and Long-Term Load Forecast peaks, read from ERCOT documents with the document URL on every row. Every row carries its unit, date and original source_url; incomplete days are flagged (complete=false), never filled. Response has `attribution` (TexasHomeBills™ + link) and `sources` (original publishers with URLs and terms).
get
/market/municipal-rates
Austin Energy and CPS Energy residential rate components with effective dates (current, or history with start/end).
get
/market/regulatory
PUCT news releases and recent rule changes (title, date, link). Every row carries its unit, date and original source_url; incomplete days are flagged (complete=false), never filled. Response has `attribution` (TexasHomeBills™ + link) and `sources` (original publishers with URLs and terms).
get
/market/rto-demand
EIA-930 daily electricity demand (MWh per Central-time day, preliminary) of ERCOT, PJM, MISO, CAISO, NYISO, ISO-NE, SPP and the Lower 48 since 2019. Every row carries its unit, date and original source_url; incomplete days are flagged (complete=false), never filled. Response has `attribution` (TexasHomeBills™ + link) and `sources` (original publishers with URLs and terms).
get
/market/stats
TexasHomeBills daily statistics from Power to Choose: per utility (listings, price and annual-cost percentiles, shares) or per provider (listings, rank, EFL-check results, ratings).
get
/market/steo
EIA Short-Term Energy Outlook series: retail and wholesale electricity prices, ERCOT load and generation by fuel, U.S. generation shares, Henry Hub. Rows with status 'projection' are EIA projections, not observed values. Every row carries its unit, date and original source_url; incomplete days are flagged (complete=false), never filled. Response has `attribution` (TexasHomeBills™ + link) and `sources` (original publishers with URLs and terms).
get
/market/texas-retail
EIA Texas monthly retail price/sales/customers/revenue by sector; BLS CPI and average prices. Free window per series = its latest 30 days (latest month for monthly series). Every row carries its unit, date and original source_url; incomplete days are flagged (complete=false), never filled. Response has `attribution` (TexasHomeBills™ + link) and `sources` (original publishers with URLs and terms).
get
/market/us-states
EIA retail electricity by state: average price (¢/kWh), sales, revenue, customers by sector for 50 states, DC and the U.S. total (monthly since 2001). Free window per series = the latest month. Every row carries its unit, date and original source_url; incomplete days are flagged (complete=false), never filled. Response has `attribution` (TexasHomeBills™ + link) and `sources` (original publishers with URLs and terms).
get
/market/weather
NOAA NCEI daily TMAX/TMIN/TAVG (°F) at 8 Texas airports with CDD/HDD (base 65°F, computed by TexasHomeBills). Every row carries its unit, date and original source_url; incomplete days are flagged (complete=false), never filled. Response has `attribution` (TexasHomeBills™ + link) and `sources` (original publishers with URLs and terms).
get
/market/wholesale
ERCOT settlement point prices (USD/MWh) at hubs and load zones, real-time or day-ahead, daily or hourly. Every row carries its unit, date and original source_url; incomplete days are flagged (complete=false), never filled. Response has `attribution` (TexasHomeBills™ + link) and `sources` (original publishers with URLs and terms).
get
/market/wireless
BLS CPI for wireless telephone services (dataset=cpi) and FCC informal complaints about cell phone service as monthly counts (dataset=complaints national or by state, dataset=issues by type). The FCC does not verify complaints; counts are not rates per subscriber. Every row carries its unit, date and original source_url; incomplete days are flagged (complete=false), never filled. Response has `attribution` (TexasHomeBills™ + link) and `sources` (original publishers with URLs and terms).
get
/news
Legacy path, still supported: same as GET /electricity/news. Guides and news
get
/plans
Legacy path, still supported: same as GET /electricity/plans. Active plans (paged)
get
/plans/{id}
Legacy path, still supported: same as GET /electricity/plans/{id}. One plan with prices, fees, credit and monthly bill estimates
get
/providers
Legacy path, still supported: same as GET /electricity/providers. PUCT-certified retail electric providers
get
/rank
Legacy path, still supported: same as GET /electricity/rank. Rank plans in a utility by estimated annual cost for a usage
get
/trends
Legacy path, still supported: same as GET /electricity/trends. Electricity prices vs inflation: BLS CPI electricity and all items, EIA Texas residential price, monthly index (2020-01 = 100)
get
/utilities
Legacy path, still supported: same as GET /electricity/utilities. Texas utilities (TDUs), cities, plan counts, lowest/median fixed price
get
/zip/{zip}
Legacy path, still supported: same as GET /electricity/zip/{zip}. Utility (TDU) serving a Texas ZIP code; empty = not in the competitive market
Copy
Copy Markdown
Copy Markdown
Copying…
Copied
Copy failed
Generate code
Planned domain (home internet): always 404 with status=planned
get
/internet
Request
Base URL:
https://texashomebills.com/api/v1
URL:
https://texashomebills.com/api/v1/internet
Auth:
one of:
none
API key in header
X-API-Key
HTTP bearer
Changes