Refrigeration / heat-pump COP API

Coefficient of performance COP = Q/W for a real cooling or heating cycle, with the Carnot-limit COP and second-law (relative) efficiency when reservoir temperatures are supplied. Answers 'What is the COP of my AC unit?', 'How close is this heat pump to the Carnot limit?'.

Price$0.04per request

MethodPOST

Route/v1/engineering/refrigeration-cop

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache0s public

engineeringthermofluidsthermodynamicscoprefrigerationheat-pumpcoolingsecond-law-efficiency

API URLhttps://x402.hexl.dev/v1/engineering/refrigeration-cop

Integration docs

Example request

{
  "mode": "cooling",
  "heatJ": 3000,
  "workJ": 1000,
  "coldTempK": 273,
  "hotTempK": 303
}

Example response

{
  "mode": "cooling",
  "heatJ": 3000,
  "workJ": 1000,
  "cop": 3,
  "formula": "COP_cool = Q_cold / W",
  "interpretation": "COP above 1 means more heat is moved than electrical work consumed.",
  "coldTempK": 273,
  "hotTempK": 303,
  "carnotCop": 9.1,
  "secondLawEfficiency": 0.32967
}

Input schema

{
  "type": "object",
  "required": [
    "heatJ",
    "workJ"
  ],
  "properties": {
    "mode": {
      "type": "string",
      "enum": [
        "cooling",
        "heating"
      ],
      "examples": [
        "cooling"
      ]
    },
    "heatJ": {
      "type": "number",
      "description": "heat moved (J or W); Q_cold for cooling, Q_hot for heating",
      "examples": [
        3000
      ]
    },
    "workJ": {
      "type": "number",
      "description": "work / electrical input (J or W)"
    },
    "coldTempK": {
      "type": "number",
      "description": "cold reservoir temperature (K) for Carnot limit"
    },
    "hotTempK": {
      "type": "number",
      "description": "hot reservoir temperature (K)"
    }
  }
}

Output schema

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