Heat pump vs furnace CO2 & cost API

Compare a heat pump against a gas/oil furnace for a given annual heat demand (kWh): heat pump electricity = heat/COP (default seasonal COP 3), CO2 = elec x grid, cost = elec x price; furnace fuel = heat/efficiency, CO2 = fuel x factor (gas 0.184, oil 0.249 kg/kWh). Returns each option's kg CO2e and USD cost, kg/USD saved, reduction percent and tree equivalents. Answers 'CO2 saved by a heat pump','heat pump vs gas furnace cost','emissions of electric heating with COP 3','should I switch from oil heat'.

Price$0.01per request

MethodPOST

Route/v1/calc/carbon-heat-pump-savings

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

carbonheat-pumpheatingfurnaceemissionsco2savingsenergy

API URLhttps://x402.hexl.dev/v1/calc/carbon-heat-pump-savings

Integration docs

Example request

{
  "annualHeatKwh": 10000
}

Example response

{
  "annualHeatKwh": 10000,
  "copHeatPump": 3,
  "furnaceFuel": "gas",
  "furnaceEfficiency": 0.9,
  "heatPumpElectricityKwh": 3333.33,
  "heatPumpKgCO2e": 1333.33,
  "heatPumpCostUsd": 500,
  "furnaceKgCO2e": 2044.44,
  "furnaceCostUsd": 666.67,
  "savedKgCO2e": 711.11,
  "savedCostUsd": 166.67,
  "reductionPercent": 34.78,
  "equivalentTrees": 33.86
}

Input schema

{
  "type": "object",
  "required": [
    "annualHeatKwh"
  ],
  "properties": {
    "annualHeatKwh": {
      "type": "number",
      "description": "useful heat delivered per year, kWh",
      "examples": [
        10000
      ]
    },
    "copHeatPump": {
      "type": "number",
      "default": 3
    },
    "gridKgCO2PerKwh": {
      "type": "number",
      "default": 0.4
    },
    "electricityPriceUsdPerKwh": {
      "type": "number",
      "default": 0.15
    },
    "furnaceFuel": {
      "type": "string",
      "enum": [
        "gas",
        "oil"
      ],
      "default": "gas"
    },
    "furnaceEfficiency": {
      "type": "number",
      "default": 0.9
    },
    "fuelPriceUsdPerUnit": {
      "type": "number",
      "description": "$/kWh of fuel energy"
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}