{
  "meta": {
    "schemaVersion": "1.0",
    "id": "knowledge:methodology:volatility",
    "type": "methodology",
    "slug": "volatility",
    "title": "Volatility Index Methodology",
    "description": "Coefficient of variation methodology for rate volatility over a window.",
    "canonicalUrl": "https://priceofelectricity.com/knowledge/methodology/volatility",
    "jsonUrl": "https://priceofelectricity.com/knowledge/methodology/volatility.json",
    "updatedAt": "2026-01-15T00:00:00.000Z",
    "sourceVersion": "v20260115",
    "temporalContext": {
      "sourceVersion": "v20260115",
      "isLatest": true
    },
    "provenance": [
      {
        "id": "poe-methodology-volatility",
        "sourceName": "PriceOfElectricity.com methodology: Volatility",
        "sourceUrl": "https://priceofelectricity.com/knowledge/methodology/volatility",
        "publisher": "PriceOfElectricity.com",
        "license": "Site content license",
        "retrievedAt": "2026-01-15T00:00:00.000Z"
      }
    ],
    "fieldProvenance": [
      {
        "field": "data.definition",
        "provenanceIds": [
          "poe-methodology-volatility"
        ]
      },
      {
        "field": "data.inputs",
        "provenanceIds": [
          "poe-methodology-volatility"
        ]
      },
      {
        "field": "data.steps",
        "provenanceIds": [
          "poe-methodology-volatility"
        ]
      },
      {
        "field": "data.limitations",
        "provenanceIds": [
          "poe-methodology-volatility"
        ]
      },
      {
        "field": "data.relatedInternalUrls",
        "provenanceIds": [
          "poe-methodology-volatility"
        ]
      }
    ],
    "citations": [
      {
        "sourceName": "PriceOfElectricity.com methodology: Volatility",
        "sourceUrl": "https://priceofelectricity.com/knowledge/methodology/volatility",
        "retrievedAt": "2026-01-15T00:00:00.000Z"
      }
    ],
    "llmHints": {
      "priority": "high",
      "entityType": "methodology",
      "semanticTopics": [
        "methodology",
        "electricity rates",
        "index calculation",
        "data freshness"
      ],
      "semanticCluster": "calculation-framework"
    },
    "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": "Volatility Index Methodology. Defines how volatility index is computed from inputs and produces derived fields used across state and ranking pages.",
    "disclaimerRefs": [
      "methodology"
    ],
    "methodology": {
      "id": "volatility",
      "version": "1.0",
      "lastReviewedAt": "2026-01-15",
      "relatedDerivedFields": [
        "data.sortedStates"
      ]
    },
    "qualityScore": 100,
    "contentHash": "6b9ce54c9b59ac0aeca540f5c91d6582c1028e421bbc7df93cdab7e3a02c9ae8",
    "integrity": {
      "contentHash": "6b9ce54c9b59ac0aeca540f5c91d6582c1028e421bbc7df93cdab7e3a02c9ae8",
      "integrityAlgorithm": "sha256",
      "signedAtBuild": "2026-01-15T00:00:00.000Z"
    }
  },
  "data": {
    "definition": "Volatility index uses coefficient of variation (stdev/mean) of monthly rates over a consistent window.",
    "inputs": [
      "Historical monthly avgRateCentsPerKwh",
      "Window (e.g. last 5 years)"
    ],
    "steps": [
      "Filter to window (e.g. last 5 years monthly).",
      "Compute mean and standard deviation.",
      "volatilityPct = (stdev / mean) * 100."
    ],
    "limitations": [
      "Requires historical time-series data. Rankings are disabled when history is unavailable.",
      "Window choice affects comparability."
    ],
    "relatedInternalUrls": [
      "https://priceofelectricity.com/knowledge/rankings/volatility-5y"
    ],
    "relatedEntities": {
      "national": true,
      "rankings": [
        "volatility-5y"
      ]
    }
  }
}