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/us-states

Request

  • Base URL: https://texashomebills.com/api/v1
  • URL: https://texashomebills.com/api/v1/market/us-states
  • Auth: one of:
    • none
    • API key in header X-API-Key
    • HTTP bearer

Query parameters

statestring

two-letter code(s), comma-separated; US = U.S. total; all (default TX,US)

sectorstring

res (default), com, ind, tra, all

measurestring

price (default), sales, revenue, customers, or all

startstring

YYYY-MM-DD. Default: 30 days ending at the series' latest date. Without a Pro key, start must be within the most recent 30 days (else 403 pro_required).

endstring

YYYY-MM-DD (default: latest date)

limitinteger

rows per response (default 1000; max 5,000 free, 20,000 Pro)

offsetinteger

rows to skip; responses give total, next_offset and next

Response

JSON with an attribution block; every item has url and a ready cite line to show users

Changes

No recorded changes to this operation across all 1 revision of this API.