Developer Docs

Grid Shopper publishes public electricity market data for tracked utility territories. The API is read-only, CORS-enabled, and intended for lookup, comparison, and citation workflows.

Machine-readable entry points

• OpenAPI document
• LLMs guide
• Methodology and data sources

Endpoints

• GET /api/v1/utilities: directory of tracked utility territories.
• GET /api/v1/utilities/{state}/{utility}: current summary metrics for one territory.
• GET /api/v1/utilities/{state}/{utility}/offers: current supplier offers, with optional filters.
• GET /api/v1/utilities/{state}/{utility}/history: recent daily lowest-offer history.

Freshness semantics

API responses expose updated_at for the data snapshot. Editorial blog posts may also display a live market-data timestamp, but that is separate from the article's own publish or edit date.

Provenance

Summary, offers, and history responses include a sources object with the Grid Shopper territory page, the official rateboard URL when available, and links to methodology and documentation. Offer rows also includesource_url when an upstream supplier document URL is available.

Examples

• /api/v1/utilities
• /api/v1/utilities/pa/peco
• /api/v1/utilities/pa/peco/offers?max_term=12
• /api/v1/utilities/pa/peco/history?days=30