Circular shaft torsion API

Computes polar moment J, maximum shear stress τ=T·r/J and angle of twist θ=TL/(GJ) for a solid or hollow circular shaft, plus FoS and torque capacity against an allowable shear. Answers 'What is the shear stress in a shaft under torque?', 'How much does a shaft twist?'.

Price$0.06per request

MethodPOST

Route/v1/engineering/shaft-torsion

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache0s public

engineeringmechanicstorsionshaftshear-stressangle-of-twistpolar-momentdrivetrain

API URLhttps://x402.hexl.dev/v1/engineering/shaft-torsion

Integration docs

Example request

{
  "torqueNm": 500,
  "outerDiameterM": 0.05,
  "lengthM": 1,
  "shearModulusPa": 80000000000,
  "allowableShearPa": 100000000
}

Example response

{
  "torqueNm": 500,
  "outerDiameterM": 0.05,
  "innerDiameterM": 0,
  "polarMomentM4": 6.13592e-7,
  "maxShearStressPa": 20371832.715763,
  "maxShearStressMPa": 20.371833,
  "formula": "J = π*(D^4 - d^4)/32, τ = T*r/J, θ = T*L/(G*J)",
  "lengthM": 1,
  "shearModulusPa": 80000000000,
  "angleOfTwistRad": 0.010185916,
  "angleOfTwistDeg": 0.58361,
  "allowableShearPa": 100000000,
  "factorOfSafety": 4.9087,
  "torqueCapacityNm": 2454.3693
}

Input schema

{
  "type": "object",
  "required": [
    "torqueNm",
    "outerDiameterM"
  ],
  "properties": {
    "torqueNm": {
      "type": "number",
      "description": "applied torque (N·m)",
      "examples": [
        500
      ]
    },
    "outerDiameterM": {
      "type": "number",
      "description": "outer diameter (m)"
    },
    "innerDiameterM": {
      "type": "number",
      "description": "inner diameter for hollow shaft (m), default 0"
    },
    "lengthM": {
      "type": "number",
      "description": "shaft length (m) for twist"
    },
    "shearModulusPa": {
      "type": "number",
      "description": "shear modulus G (Pa) for twist"
    },
    "allowableShearPa": {
      "type": "number",
      "description": "allowable shear (Pa) for FoS"
    }
  }
}

Output schema

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