# Halowerk Geomagnetic Storm Risk Classifier

> Halowerk Geomagnetic Storm Risk Classifier is a paid API for AI agents from space.halowerk.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Maps caller-supplied Kp and Dst indices to geomagnetic storm severity bands (G0–G5) and combines them with geomagnetic latitude and infrastructure class to assess impact risk.

## Facts

- Endpoint: POST https://space.halowerk.com/v1/geomagnetic-storm
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-geomagnetic-storm-risk-classifier-adb1d681
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WOXTbilEuTjsjwGEyst9b

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-geomagnetic-storm-risk-classifier-adb1d681 -d '<json body>'
```

Example prompt: Given a Kp index of 7.3 and a Dst of -120 nT, what G-band storm severity does that map to for a power grid at 65 degrees geomagnetic latitude?

## When to prefer this

Choose this endpoint when you already have Kp and/or Dst measurements and need a standardized G-band classification combined with infrastructure-specific risk context — especially when you need to assess impact by latitude and asset type. This is a pure computation endpoint, not a data retrieval or forecasting service; use it after obtaining space weather observations from another source.

## Known failure modes

- Kp index out of range (0–9) returns validation error
- Dst value outside allowed range (-2000 to +1000 nT) returns validation error
- Unrecognized infrastructure enum value returns error
- Missing required fields may result in incomplete or error response
- Geomagnetic latitude outside -90 to +90 degrees returns validation error

## How this service works

Maps a caller-supplied Kp value to conventional G0–G5 bands, maps Dst to declared disturbance bands, and combines severity with geomagnetic latitude and infrastructure class. It does not retrieve observations, forecast a storm, model local ground conductivity, or predict equipment failure.

## Output

Returns the mapped G-band storm severity (G0–G5) from the Kp index, a declared disturbance band from the Dst value, and a combined severity-infrastructure-latitude risk rating indicating the expected impact level for the specified infrastructure class.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "kp_index": {
   "type": "number",
   "maximum": 9,
   "minimum": 0
  },
  "dst_nanotesla": {
   "type": "number",
   "maximum": 1000,
   "minimum": -2000
  },
  "infrastructure": {
   "enum": [
    "satellite",
    "radio",
    "navigation",
    "power_grid",
    "pipeline"
   ],
   "type": "string"
  },
  "geomagnetic_latitude_deg": {
   "type": "number",
   "maximum": 90,
   "minimum": -90
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-geomagnetic-storm-risk-classifier-adb1d681/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from space.halowerk.com](https://www.zero.xyz/host/space.halowerk.com/llms.txt)