data

US retail electricity price, sales and customers by state and sector — $0.007

Average retail electricity price (cents/kWh), sales, customers and revenue for residential, commercial, industrial, transportation and all sectors in one US state (or US total), latest month with year-ago comparison. Source: U.S. Energy Information Administration (EIA-861M) (public domain (US federal)). Cadence: monthly; observed_at in the response is the upstream timestamp.

get/v1/data/energy/electricity-retail/{state}

Request

  • Base URL: https://x402.asterpay.io
  • URL: https://x402.asterpay.io/v1/data/energy/electricity-retail/{state}
  • Auth: one of:
    • API key in header PAYMENT-SIGNATURE
    • HTTP payment

Path parameters

statestring required
Example:TX

US or two-letter state code

Response

US retail electricity price, sales and customers by state and sector

successboolean required
dataobject required

Door-specific payload; see the door description and GET /v1/data for an example URL

observed_atstring nullable required

Upstream publication/observation time (ISO 8601). Never the AsterPay fetch time.

fetched_atstring required

When AsterPay last fetched from the upstream

cadence'live' | '5m' | '15m' | 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly' required
next_expectedstring nullable

Earliest time a newer upstream value is expected

cache_expires_atstring
staleboolean required

true when the upstream failed and a cached copy under 24h old was served

timestampstring required

Changes

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