Forecast API

Risk quantification, cost models, and scenario calculations.

Dashboard

GET /api/v1/forecast/dashboard?state=NH

Returns risk summary, device exposures, and aggregate financial metrics for the specified state.

Energy Rates

GET /api/v1/forecast/energy-rates

Returns industrial electricity rates for all 50 states + DC (source: EIA).

{
  "rates": [
    {
      "state_code": "NH",
      "state_name": "New Hampshire",
      "rate_per_kwh": 0.1345,
      "source": "EIA",
      "year": 2024
    }
  ]
}

Equipment Costs

GET /api/v1/forecast/equipment-costs?vendor=Rockwell&deviceType=plc

Returns equipment replacement cost data from public distributor pricing.

Industry Benchmarks

GET /api/v1/forecast/benchmarks?industry=manufacturing

Returns production rates, downtime cost estimates, and regulatory penalty ranges.

Scenario Calculator

POST /api/v1/forecast/calculate

Request Body:

{
  "equipmentCosts": [
    { "name": "ControlLogix 5580", "cost": 17500 },
    { "name": "PowerFlex 755 VFD", "cost": 12000 }
  ],
  "downtimeHours": 24,
  "productionPerHour": 15000,
  "horsepower": 400,
  "loadFactor": 0.8,
  "operatingHoursPerDay": 16,
  "state": "NH",
  "regulatoryFramework": ["OSHA", "EPA"]
}

Response:

{
  "breakdown": {
    "equipment": { "items": [...], "total": 29500 },
    "production": { "downtimeHours": 24, "ratePerHour": 15000, "total": 360000 },
    "energy": { "horsepowerTotal": 400, "kilowatts": 298.4, "annualCost": 52847 },
    "regulatory": { "frameworks": ["OSHA", "EPA"], "estimatedLow": 50000, "estimatedHigh": 250000 }
  },
  "totals": {
    "equipmentExposure": 29500,
    "productionExposure": 360000,
    "annualEnergyCost": 52847,
    "regulatoryExposureLow": 50000,
    "regulatoryExposureHigh": 250000,
    "totalExposure": 492347,
    "worstCaseExposure": 692347
  }
}

Device Risk

GET /api/v1/forecast/device/:id?state=NH

Returns per-device financial risk breakdown including equipment cost, downtime exposure, energy cost, CVE count, and risk-adjusted total.