curl --request POST \
  --url https://api.fincept.in/quantlib/physics/thermodynamics/free-energy \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "internal_energy": 1000,
  "temperature": 300,
  "entropy": 2.5,
  "type": "helmholtz"
}
'

{
  "success": true,
  "data": {
    "gibbs_free_energy": 2520.68,
    "helmholtz_free_energy": 250,
    "enthalpy": 3270.68
  }
}

{
  "detail": "Invalid API key"
}

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

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

quantlib-physics

Calculate Thermodynamic Free Energy

Calculates various forms of thermodynamic free energy: Gibbs free energy (G), Helmholtz free energy (F), or enthalpy (H). Free energy represents the maximum useful work extractable from a system and is fundamental in thermodynamics. In finance, free energy concepts apply to portfolio efficiency, market stability, and equilibrium analysis.

Use Cases:

Assess portfolio efficiency (maximum utility extraction)
Market equilibrium and stability analysis
Energy-based risk models
Thermodynamic analogies in market microstructure
Path-dependent work extraction in trading

Formulas:

Gibbs: G = U + PV - TS (constant T,P)
Helmholtz: F = U - TS (constant T,V)
Enthalpy: H = U + PV

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

POST

quantlib

physics

thermodynamics

free-energy

curl --request POST \
  --url https://api.fincept.in/quantlib/physics/thermodynamics/free-energy \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "internal_energy": 1000,
  "temperature": 300,
  "entropy": 2.5,
  "type": "helmholtz"
}
'

{
  "success": true,
  "data": {
    "gibbs_free_energy": 2520.68,
    "helmholtz_free_energy": 250,
    "enthalpy": 3270.68
  }
}

{
  "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

internal_energy

number

required

Internal energy U

Example:

1000

temperature

number

required

Temperature T

Example:

300

entropy

number

required

Entropy S

Example:

2.5

pressure

number

default:0

Pressure P (required for Gibbs and enthalpy)

Example:

101325

volume

number

default:0

Volume V (required for Gibbs and enthalpy)

Example:

0.0224

type

enum<string>

default:gibbs

Type of free energy to calculate

Available options:

gibbs,

helmholtz,

enthalpy

Example:

"helmholtz"

Response

Free energy 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 Thermodynamic Free Energy

Authorizations

Body

Response