# Grid Shopper

Grid Shopper tracks electricity supplier offers and utility default rates across U.S. retail markets.

Primary API base: https://gridshopper.com/api/v1
Developer docs: https://gridshopper.com/developers
OpenAPI: https://gridshopper.com/api/v1/openapi.json
Methodology: https://gridshopper.com/methodology/data-sources

## Endpoints
- GET /api/v1/utilities
  Returns utility directory records with IDs, Grid Shopper page URLs, and rateboard links.
- GET /api/v1/utilities/{state}/{utility}
  Returns summary metrics for one utility territory.
  Example response:
  ```json
  {
    "id": "pa/peco",
    "name": "PECO",
    "state": "Pennsylvania",
    "state_abbr": "PA",
    "updated_at": "2026-03-08T19:11:33.109Z",
    "utility_rate": 0.11024,
    "nopec_rate": null,
    "market": {
      "supplier_count": 42,
      "offer_count": 132,
      "avg_12month_rate": 0.1367,
      "avg_rate_change_1d": null,
      "avg_rate_change_7d": 0.1100
    },
    "lowest_offer": {
      "supplier": "Inspire Clean Energy",
      "term_months": 3,
      "rate": 0.0899,
      "rate_change_1d": null,
      "rate_change_7d": -0.3000
    },
    "source": "Pennsylvania rateboard",
    "url": "https://gridshopper.com/pa/peco",
    "sources": {
      "territory_page_url": "https://gridshopper.com/pa/peco",
      "rateboard_url": "https://www.papowerswitch.com/",
      "methodology_url": "https://gridshopper.com/methodology/data-sources",
      "documentation_url": "https://gridshopper.com/developers"
    }
  }
  ```
- GET /api/v1/utilities/{state}/{utility}/offers?max_term=12&supplier=inspire
  Returns current offers, optionally filtered by term length and supplier name. Offer rows may include `source_url`.
- GET /api/v1/utilities/{state}/{utility}/history?days=30
  Returns daily lowest-offer history and 12-month aggregates (default 30 days, max 180).

## Data Notes
- Rates are decimal USD/kWh values (example: 0.11024).
- Utility territories are identified by {state}/{utility}.
- Some fields are optional by market (for example utility default rate, NOPEC rate, usage forecasts).
- `updated_at` refers to data freshness, not editorial article freshness.

## Utility IDs
- pa/duquesne
- pa/meted
- pa/peco
- pa/ppl
- pa/penelec
- pa/penn-power
- pa/west-penn
- oh/aep
- oh/aes
- oh/deok
- oh/ohioedison
- oh/ceic
- oh/toledoedison
- il/comed
- tx/centerpoint
- tx/oncor
- tx/aepc
- tx/aepn
- tx/tnmp
- tx/lpl
- ct/eversource
- ct/ui
- ma/eversource-east
- ma/eversource-west
- ma/nantucket
- ma/ngrid-nema
- ma/ngrid-sema
- ma/ngrid-wmeco
- ma/fitchburg
- ny/coned
- ny/central-hudson
- ny/rge
- ny/ngrid-western-ny
- ny/ngrid-capital-region
- ny/nyseg-western-ny
- ny/oandr

## Common Questions
- What are the lowest available rates in {state}/{utility}?
- How many offers are below the current utility default rate?
- How has the average 12-month offer rate moved over the last 30 days?
- Which suppliers currently offer terms up to 12 months?
- What changed in rates over 1 day and 7 days for a utility territory?