curl --request POST \
  --url https://api.fincept.in/quantlib/physics/thermodynamics/carnot \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "T_hot": 600,
  "T_cold": 300,
  "Q_hot": 1000
}
'

{
  "success": true,
  "data": {
    "efficiency": 0.5,
    "work_per_cycle": 500,
    "heat_rejected": 500,
    "cop_refrigerator": 1,
    "cop_heat_pump": 2
  }
}

{
  "detail": "Invalid API key"
}

{
  "detail": "Insufficient credits. This endpoint requires 5 credits."
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

quantlib-physics

Calculate Carnot Cycle Properties

Calculates properties of an ideal Carnot heat engine cycle operating between hot and cold reservoirs. Returns maximum theoretical efficiency, work output per cycle, heat rejected, and coefficients of performance for refrigerator and heat pump modes. The Carnot efficiency sets fundamental limits on energy conversion efficiency.

Use Cases:

Theoretical efficiency bounds for financial engines
Information-to-profit conversion limits
Market maker efficiency analysis
Energy/work analogies in portfolio rebalancing
Maximum extractable value calculations

Formula: η_Carnot = 1 - T_cold/T_hot (maximum efficiency)

Credits: 5 credits per request (Pro Tier) [Tier: ENTERPRISE, Credits: 10]

POST

quantlib

physics

thermodynamics

carnot

curl --request POST \
  --url https://api.fincept.in/quantlib/physics/thermodynamics/carnot \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "T_hot": 600,
  "T_cold": 300,
  "Q_hot": 1000
}
'

{
  "success": true,
  "data": {
    "efficiency": 0.5,
    "work_per_cycle": 500,
    "heat_rejected": 500,
    "cop_refrigerator": 1,
    "cop_heat_pump": 2
  }
}

{
  "detail": "Invalid API key"
}

{
  "detail": "Insufficient credits. This endpoint requires 5 credits."
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

X-API-Key

string

header

required

API key for authentication. Get your key at https://api.fincept.in/auth/register

Body

application/json

T_hot

number

required

Hot reservoir temperature (absolute temperature, e.g., Kelvin)

Example:

500

T_cold

number

required

Cold reservoir temperature (absolute temperature, must be less than T_hot)

Example:

300

Q_hot

number

default:1000

Heat absorbed from hot reservoir per cycle

Example:

1000

Response

Carnot cycle properties calculated successfully

success

boolean

Example:

true

data

object

Show child attributes

Free Tier (0 credits)

Basic Tier (1 credit)

Standard Tier (2 credits)

Pro Tier (5 credits)

Enterprise Tier (10 credits)

Calculate Carnot Cycle Properties

Authorizations

Body

Response