{
  "meta": {
    "schemaVersion": "1.0",
    "id": "knowledge:methodology:momentum-signal",
    "type": "methodology",
    "slug": "momentum-signal",
    "title": "Momentum Signal Methodology",
    "description": "Directional historical signal for electricity price trend direction.",
    "canonicalUrl": "https://priceofelectricity.com/knowledge/methodology/momentum-signal",
    "jsonUrl": "https://priceofelectricity.com/knowledge/methodology/momentum-signal.json",
    "updatedAt": "2026-02-22T00:00:00.000Z",
    "sourceVersion": "v20260222",
    "temporalContext": {
      "sourceVersion": "v20260222",
      "isLatest": true
    },
    "provenance": [
      {
        "id": "poe-methodology-momentum-signal",
        "sourceName": "PriceOfElectricity.com methodology: Momentum Signal",
        "sourceUrl": "https://priceofelectricity.com/knowledge/methodology/momentum-signal",
        "publisher": "PriceOfElectricity.com",
        "license": "Site content license",
        "retrievedAt": "2026-02-22T00:00:00.000Z"
      }
    ],
    "fieldProvenance": [
      {
        "field": "data.definition",
        "provenanceIds": [
          "poe-methodology-momentum-signal"
        ]
      },
      {
        "field": "data.inputs",
        "provenanceIds": [
          "poe-methodology-momentum-signal"
        ]
      },
      {
        "field": "data.steps",
        "provenanceIds": [
          "poe-methodology-momentum-signal"
        ]
      },
      {
        "field": "data.limitations",
        "provenanceIds": [
          "poe-methodology-momentum-signal"
        ]
      },
      {
        "field": "data.relatedInternalUrls",
        "provenanceIds": [
          "poe-methodology-momentum-signal"
        ]
      }
    ],
    "citations": [
      {
        "sourceName": "PriceOfElectricity.com methodology: Momentum Signal",
        "sourceUrl": "https://priceofelectricity.com/knowledge/methodology/momentum-signal",
        "retrievedAt": "2026-02-22T00:00:00.000Z"
      }
    ],
    "llmHints": {
      "priority": "high",
      "entityType": "methodology",
      "semanticTopics": [
        "methodology",
        "electricity rates",
        "index calculation",
        "data freshness"
      ],
      "semanticCluster": "calculation-framework"
    },
    "freshness": {
      "datasetUpdatedAt": "2026-02-22T00:00:00.000Z",
      "computedAt": "2026-02-22T00: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": "Momentum Signal Methodology. Defines how metrics is computed from inputs and produces derived fields used across state and ranking pages.",
    "disclaimerRefs": [
      "methodology"
    ],
    "methodology": {
      "id": "momentum-signal",
      "version": "1.0",
      "lastReviewedAt": "2026-02-22",
      "relatedDerivedFields": [
        "data.sortedStates",
        "data.derived.momentum"
      ]
    },
    "qualityScore": 100,
    "contentHash": "c341ab875a4941b7d7f985c2fa21acd4fad5ff6bccadd88c08a9666b1871be77",
    "integrity": {
      "contentHash": "c341ab875a4941b7d7f985c2fa21acd4fad5ff6bccadd88c08a9666b1871be77",
      "integrityAlgorithm": "sha256",
      "signedAtBuild": "2026-02-22T00:00:00.000Z"
    }
  },
  "data": {
    "definition": "The momentum signal is a directional historical signal that summarizes whether a state's electricity prices appear to be accelerating, rising, stable, or falling. It is not a forecast.",
    "inputs": [
      "Historical monthly avgRateCentsPerKwh",
      "Short window (~12 months ago to most recent)",
      "Long window (~24 months ago to most recent)"
    ],
    "steps": [
      "Use up to 24 most recent monthly points.",
      "Require at least 6 usable points for a signal.",
      "shortWindowChange = percent change from ~12 months ago to most recent.",
      "longWindowChange = percent change from ~24 months ago to most recent.",
      "acceleration = shortWindowChange - (longWindowChange / comparable_years_factor).",
      "Classify: accelerating (shortWindowChange > 3% AND acceleration > 1%), rising (shortWindowChange > 1%), falling (shortWindowChange < -1%), otherwise stable.",
      "momentumScore: accelerating = 2 + shortWindowChange, rising = 1 + shortWindowChange, stable = 0, falling = -1 + shortWindowChange."
    ],
    "limitations": [
      "This is a directional historical signal, not a forecast.",
      "Missing or limited history can make the signal unavailable.",
      "Thresholds are deterministic and transparent."
    ],
    "relatedInternalUrls": [
      "https://priceofelectricity.com/knowledge/rankings/momentum-signal"
    ],
    "relatedEntities": {
      "national": true,
      "rankings": [
        "momentum-signal"
      ]
    }
  }
}
