Miner's cumulative damage API

Applies Miner's linear damage rule D=Σ(nᵢ/Nᵢ) over variable-amplitude load blocks, returning total damage, failure prediction, remaining-life fraction and repeats-to-failure. Answers 'Has my variable load spectrum used up the part's fatigue life?', 'How many more times can I run this sequence?'.

Price$0.06per request

MethodPOST

Route/v1/engineering/miner-cumulative-damage

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache0s public

fatigueminercumulative-damagepalmgren-minervariable-amplitudelife-fractionspectrummachine-design

API URLhttps://x402.hexl.dev/v1/engineering/miner-cumulative-damage

Integration docs

Example request

{
  "blocks": [
    {
      "appliedCycles": 1000,
      "lifeCycles": 5000
    },
    {
      "appliedCycles": 2000,
      "lifeCycles": 8000
    }
  ]
}

Example response

{
  "totalDamage": 0.45,
  "failurePredicted": false,
  "remainingLifeFraction": 0.55,
  "sequenceRepeatsToFailure": 2.2222,
  "perBlock": [
    {
      "appliedCycles": 1000,
      "lifeCycles": 5000,
      "damage": 0.2
    },
    {
      "appliedCycles": 2000,
      "lifeCycles": 8000,
      "damage": 0.25
    }
  ],
  "formula": "D = Σ(nᵢ/Nᵢ), failure at D ≥ 1",
  "interpretation": "Damage below 1 — the part survives this loading block; multiply the sequence to estimate total life."
}

Input schema

{
  "type": "object",
  "required": [
    "blocks"
  ],
  "properties": {
    "blocks": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "appliedCycles",
          "lifeCycles"
        ],
        "properties": {
          "appliedCycles": {
            "type": "number"
          },
          "lifeCycles": {
            "type": "number"
          }
        }
      },
      "examples": [
        [
          {
            "appliedCycles": 1000,
            "lifeCycles": 5000
          },
          {
            "appliedCycles": 2000,
            "lifeCycles": 8000
          }
        ]
      ]
    }
  }
}

Output schema

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