v5

OpenAPI 3.1.0Proprietary2026-08-031,5423,1505.5 MB
Energy

Retail electricity price by state and sector (EIA-861)

Average retail price of electricity (cents per kilowatthour), plus revenue, sales and customer counts, by US state (or Census region, or US national total) and consumer sector (residential, commercial, industrial, transportation), monthly from 2001 (U.S. EIA Form EIA-861). Survey-based statistics, preliminary and subject to revision; not an intraday or wholesale price (grid operating data is on /grid).

get/api/v2/energy/retail-price

Query parameters

statestring

EIA stateid: 2-letter US state code (CO, TX, ...), a Census region/division code, or US for the national total.

Example:CO

EIA stateid: 2-letter US state code (CO, TX, ...), a Census region/division code, or US for the national total.

sector'RES' | 'COM' | 'IND' | 'TRA' | 'OTH' | 'ALL'

Consumer sector: RES | COM | IND | TRA | OTH | ALL.

frequency'monthly' | 'quarterly' | 'annual'

monthly | quarterly | annual.

startstring nullable

Lower bound on period (YYYY-MM monthly, YYYY-Q[1-4] quarterly, YYYY annual).

Lower bound on period (YYYY-MM monthly, YYYY-Q[1-4] quarterly, YYYY annual).

endstring nullable

Upper bound on period.

Upper bound on period.

limitinteger

Maximum observations returned, newest first.

Maximum observations returned, newest first.

Response

Successful Response

Example response

{
  "data": {
    "query": {
      "state": "CO",
      "sector": "RES",
      "frequency": "monthly",
      "limit": 60
    },
    "state": "CO",
    "state_name": "Colorado",
    "sector": "RES",
    "sector_name": "residential",
    "frequency": "monthly",
    "units": {
      "price": "cents per kilowatthour",
      "revenue": "million dollars",
      "sales": "million kilowatthours",
      "customers": "number of customers"
    },
    "series": [
      {
        "period": "2025-03",
        "price": 16.8,
        "revenue": 1234.5,
        "sales": 7345,
        "customers": 5100000
      }
    ],
    "attribution": {
      "sources": [
        {
          "registry_key": "eia/rto",
          "source_name": "EIA",
          "licence": "public-domain",
          "citation": "U.S. Energy Information Administration, Hourly Electric Grid Monitor (Form EIA-930)",
          "disclaimer": "Operational electric-grid data; preliminary and subject to revision."
        }
      ],
      "effective_reexport": "allowed"
    },
    "disclaimer": "Survey-based retail statistics; preliminary and subject to revision."
  },
  "meta": {
    "endpoint": "/api/v1/fred/us/cpi",
    "data_time": "2026-04-16T14:30:00Z",
    "response_time": "2026-04-16T14:30:12Z",
    "provider": "Sugra API v1.0.1",
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ]
  }
}