# Halowerk IoT Battery Degradation Calculator

> Halowerk IoT Battery Degradation Calculator is a paid API for AI agents from iot.halowerk.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-14).

Estimates remaining battery capacity after cycle and calendar fade using caller-supplied or default heuristic coefficients.

## Facts

- Endpoint: POST https://iot.halowerk.com/v1/battery-degradation
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-iot-battery-degradation-calculator-6fa25e3a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Yh7X-rrCCIiPhjGryNfZW

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability halowerk-iot-battery-degradation-calculator-6fa25e3a -d '<json body>'
```

Example prompt: Estimate how much capacity my 100 Ah battery has left after 800 equivalent full cycles at an average depth of discharge of 75%, stored and used for 730 calendar days at an average temperature of 35°C — use a cycle fade of 0.02% per full cycle and a calendar fade of 2% per sqrt year.

## When to prefer this

Choose this endpoint when you need a fast, deterministic, physics-inspired battery degradation estimate from known usage parameters (cycles, DoD, time, temperature) without needing a full electrochemical simulation or cell-chemistry-specific model. It is ideal for IoT fleet management dashboards, predictive maintenance triggers, and energy storage lifecycle planning where approximate heuristic accuracy is sufficient and low latency matters. Not suitable for warranty assessment, safety certification, or precise cell-chemistry validation.

## Known failure modes

- Missing required fields (initial_capacity_ah) returns a 400 validation error
- Out-of-range values (e.g. temperature > 150°C or DoD > 100%) return a 422 or 400 error
- Negative or zero initial capacity triggers minimum constraint violation
- Very large cycle counts or calendar days may produce near-zero or negative capacity outputs that must be interpreted by the caller
- Payment failure or insufficient USDC balance returns a 402 error

## How this service works

Applies a transparent heuristic: cycle fade scales with equivalent full cycles and depth-of-discharge exponent; calendar fade scales with square-root time and a temperature factor. Coefficients are caller supplied or declared defaults. This is not cell-chemistry validation, warranty advice or a safety prognosis.

## Output

Returns estimated remaining battery capacity in Ah and the breakdown of capacity loss attributable to cycle fade (scaled by equivalent full cycles and depth-of-discharge exponent) and calendar fade (scaled by square-root of elapsed time and temperature factor), using caller-supplied coefficients or built-in defaults.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "calendar_days": {
   "type": "number",
   "maximum": 100000,
   "minimum": 0
  },
  "initial_capacity_ah": {
   "type": "number",
   "maximum": 1000000000,
   "minimum": 0.001
  },
  "average_temperature_c": {
   "type": "number",
   "maximum": 150,
   "minimum": -50
  },
  "equivalent_full_cycles": {
   "type": "number",
   "maximum": 1000000000,
   "minimum": 0
  },
  "cycle_fade_per_full_cycle_percent": {
   "type": "number",
   "maximum": 10,
   "minimum": 0
  },
  "average_depth_of_discharge_percent": {
   "type": "number",
   "maximum": 100,
   "minimum": 0
  },
  "calendar_fade_per_sqrt_year_percent": {
   "type": "number",
   "maximum": 100,
   "minimum": 0
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-iot-battery-degradation-calculator-6fa25e3a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from iot.halowerk.com](https://www.zero.xyz/host/iot.halowerk.com/llms.txt)