{
  "meta": {
    "schemaVersion": "1.0",
    "id": "knowledge:national",
    "type": "national",
    "slug": "national",
    "title": "U.S. National Electricity Pricing Overview",
    "description": "National-level summary of U.S. residential electricity rates and extremes.",
    "canonicalUrl": "https://priceofelectricity.com/knowledge/national",
    "jsonUrl": "https://priceofelectricity.com/knowledge/national.json",
    "updatedAt": "2026-01-15T00:00:00.000Z",
    "sourceVersion": "v20260115",
    "temporalContext": {
      "sourceVersion": "v20260115",
      "isLatest": true
    },
    "provenance": [
      {
        "id": "eia-retail-sales-923",
        "sourceName": "U.S. Energy Information Administration (EIA) Retail Sales of Electricity",
        "sourceUrl": "https://api.eia.gov/v2/electricity/retail-sales/data/",
        "publisher": "U.S. Energy Information Administration",
        "license": "U.S. Government work (public domain)",
        "notes": "Primary source for state residential electricity rate series used by snapshots.",
        "retrievedAt": "2026-01-15T00:00:00.000Z"
      },
      {
        "id": "poe-dataset-states-csv",
        "sourceName": "PriceOfElectricity.com dataset endpoint: states.csv",
        "sourceUrl": "https://priceofelectricity.com/api/datasets/states.csv",
        "publisher": "PriceOfElectricity.com",
        "license": "Site content license",
        "retrievedAt": "2026-01-15T00:00:00.000Z"
      },
      {
        "id": "poe-dataset-states-json",
        "sourceName": "PriceOfElectricity.com dataset endpoint: states.json",
        "sourceUrl": "https://priceofelectricity.com/api/datasets/states.json",
        "publisher": "PriceOfElectricity.com",
        "license": "Site content license",
        "retrievedAt": "2026-01-15T00:00:00.000Z"
      },
      {
        "id": "poe-methodology-epi",
        "sourceName": "PriceOfElectricity.com methodology: Electricity Price Index",
        "sourceUrl": "https://priceofelectricity.com/methodology/electricity-price-index",
        "publisher": "PriceOfElectricity.com",
        "license": "Site content license",
        "retrievedAt": "2026-01-15T00:00:00.000Z"
      }
    ],
    "fieldProvenance": [
      {
        "field": "data.raw.stateCount",
        "provenanceIds": [
          "eia-retail-sales-923",
          "poe-dataset-states-json"
        ],
        "isDerived": false
      },
      {
        "field": "data.raw.datasetUpdatedAt",
        "provenanceIds": [
          "eia-retail-sales-923",
          "poe-dataset-states-json"
        ],
        "isDerived": false
      },
      {
        "field": "data.derived.averageRate",
        "provenanceIds": [
          "eia-retail-sales-923",
          "poe-methodology-epi"
        ],
        "isDerived": true,
        "derivedFromFields": [
          "data.raw.stateCount"
        ]
      },
      {
        "field": "data.derived.medianRate",
        "provenanceIds": [
          "eia-retail-sales-923",
          "poe-methodology-epi"
        ],
        "isDerived": true,
        "derivedFromFields": [
          "data.raw.stateCount"
        ]
      },
      {
        "field": "data.derived.dispersionMetrics",
        "provenanceIds": [
          "eia-retail-sales-923",
          "poe-methodology-epi"
        ],
        "isDerived": true,
        "derivedFromFields": [
          "data.raw.stateCount"
        ]
      },
      {
        "field": "data.derived.highestState",
        "provenanceIds": [
          "eia-retail-sales-923",
          "poe-methodology-epi"
        ],
        "isDerived": true,
        "derivedFromFields": [
          "data.raw.stateCount"
        ]
      },
      {
        "field": "data.derived.lowestState",
        "provenanceIds": [
          "eia-retail-sales-923",
          "poe-methodology-epi"
        ],
        "isDerived": true,
        "derivedFromFields": [
          "data.raw.stateCount"
        ]
      },
      {
        "field": "data.derived.top5Highest",
        "provenanceIds": [
          "eia-retail-sales-923",
          "poe-methodology-epi"
        ],
        "isDerived": true,
        "derivedFromFields": [
          "data.raw.stateCount"
        ]
      },
      {
        "field": "data.derived.top5Lowest",
        "provenanceIds": [
          "eia-retail-sales-923",
          "poe-methodology-epi"
        ],
        "isDerived": true,
        "derivedFromFields": [
          "data.raw.stateCount"
        ]
      }
    ],
    "citations": [
      {
        "sourceName": "U.S. Energy Information Administration (EIA) Retail Sales of Electricity",
        "sourceUrl": "https://api.eia.gov/v2/electricity/retail-sales/data/",
        "retrievedAt": "2026-01-15T00:00:00.000Z",
        "notes": "Primary source for state residential electricity rate series used by snapshots."
      },
      {
        "sourceName": "PriceOfElectricity.com dataset endpoint: states.csv",
        "sourceUrl": "https://priceofelectricity.com/api/datasets/states.csv",
        "retrievedAt": "2026-01-15T00:00:00.000Z"
      },
      {
        "sourceName": "PriceOfElectricity.com dataset endpoint: states.json",
        "sourceUrl": "https://priceofelectricity.com/api/datasets/states.json",
        "retrievedAt": "2026-01-15T00:00:00.000Z"
      },
      {
        "sourceName": "PriceOfElectricity.com methodology: Electricity Price Index",
        "sourceUrl": "https://priceofelectricity.com/methodology/electricity-price-index",
        "retrievedAt": "2026-01-15T00:00:00.000Z"
      }
    ],
    "llmHints": {
      "priority": "high",
      "entityType": "national",
      "semanticTopics": [
        "electricity rates",
        "kwh pricing",
        "national trends",
        "state comparison"
      ],
      "semanticCluster": "macro-overview"
    },
    "freshness": {
      "datasetUpdatedAt": "2026-01-15T00:00:00.000Z",
      "computedAt": "2026-01-15T00:00:00.000Z",
      "status": "fresh",
      "ageDays": 0,
      "methodology": {
        "id": "freshness",
        "version": "1.0",
        "url": "https://priceofelectricity.com/knowledge/methodology/freshness.json",
        "canonicalUrl": "https://priceofelectricity.com/knowledge/methodology/freshness"
      }
    },
    "excerpt": "US residential electricity rate overview. Avg 17.86¢/kWh median 15.51¢/kWh Highest: Hawaii (39.79¢) Lowest: North Dakota (10.92¢)",
    "disclaimerRefs": [
      "general-site"
    ],
    "qualityScore": 100,
    "contentHash": "2005b45bfc9f4b701f1de7f034680e34006568ef85ee347bc32e0a74c1829911",
    "integrity": {
      "contentHash": "2005b45bfc9f4b701f1de7f034680e34006568ef85ee347bc32e0a74c1829911",
      "registryHash": "b832e48843b4e5f841ed5566ecb7d6762bff9fe542669a230fb895f657dc6063",
      "integrityAlgorithm": "sha256",
      "signedAtBuild": "2026-01-15T00:00:00.000Z"
    }
  },
  "data": {
    "raw": {
      "stateCount": 50,
      "datasetUpdatedAt": "2026-01-15T00:00:00.000Z"
    },
    "derived": {
      "averageRate": 17.86,
      "medianRate": 15.51,
      "dispersionMetrics": {
        "stdDev": 6.56,
        "min": 10.92,
        "max": 39.79,
        "spread": 28.87
      },
      "highestState": {
        "slug": "hawaii",
        "name": "Hawaii",
        "rate": 39.79
      },
      "lowestState": {
        "slug": "north-dakota",
        "name": "North Dakota",
        "rate": 10.92
      },
      "top5Highest": [
        {
          "slug": "hawaii",
          "name": "Hawaii",
          "rate": 39.79
        },
        {
          "slug": "massachusetts",
          "name": "Massachusetts",
          "rate": 31.16
        },
        {
          "slug": "maine",
          "name": "Maine",
          "rate": 30.73
        },
        {
          "slug": "california",
          "name": "California",
          "rate": 30.29
        },
        {
          "slug": "rhode-island",
          "name": "Rhode Island",
          "rate": 30.14
        }
      ],
      "top5Lowest": [
        {
          "slug": "north-dakota",
          "name": "North Dakota",
          "rate": 10.92
        },
        {
          "slug": "nebraska",
          "name": "Nebraska",
          "rate": 11.76
        },
        {
          "slug": "missouri",
          "name": "Missouri",
          "rate": 11.8
        },
        {
          "slug": "idaho",
          "name": "Idaho",
          "rate": 12.07
        },
        {
          "slug": "arkansas",
          "name": "Arkansas",
          "rate": 12.35
        }
      ],
      "trends": {
        "avgRateCentsPerKwh": {
          "values": [
            17.74,
            17.86,
            17.86
          ],
          "min": 17.74,
          "max": 17.86
        }
      }
    },
    "derivedMeta": {
      "methodologiesUsed": [
        {
          "id": "epi",
          "version": "1.0",
          "url": "https://priceofelectricity.com/knowledge/methodology/epi.json",
          "appliesToFields": [
            "data.derived.averageRate",
            "data.derived.medianRate",
            "data.derived.dispersionMetrics",
            "data.derived.highestState",
            "data.derived.lowestState",
            "data.derived.top5Highest",
            "data.derived.top5Lowest",
            "data.derived.trends"
          ]
        }
      ]
    },
    "relatedEntities": {
      "states": [
        "arkansas",
        "california",
        "hawaii",
        "idaho",
        "maine",
        "massachusetts",
        "missouri",
        "nebraska",
        "north-dakota",
        "rhode-island"
      ],
      "methodologies": [
        "epi",
        "value-score",
        "freshness"
      ],
      "rankings": [
        "rate-low-to-high",
        "rate-high-to-low",
        "affordability",
        "value-score"
      ]
    },
    "facts": [
      {
        "label": "Average rate",
        "value": 17.86,
        "unit": "¢/kWh",
        "sourceField": "data.derived.averageRate"
      },
      {
        "label": "Data age",
        "value": 0,
        "unit": "days",
        "sourceField": "meta.freshness.ageDays"
      },
      {
        "label": "Highest state rate",
        "value": 39.79,
        "unit": "¢/kWh",
        "sourceField": "data.derived.highestState.rate"
      },
      {
        "label": "Lowest state rate",
        "value": 10.92,
        "unit": "¢/kWh",
        "sourceField": "data.derived.lowestState.rate"
      },
      {
        "label": "Median rate",
        "value": 15.51,
        "unit": "¢/kWh",
        "sourceField": "data.derived.medianRate"
      },
      {
        "label": "Rate spread",
        "value": 28.87,
        "unit": "¢/kWh",
        "sourceField": "data.derived.dispersionMetrics.spread"
      },
      {
        "label": "State count",
        "value": 50,
        "sourceField": "data.raw.stateCount"
      }
    ]
  }
}