# NWS/SPC Severe Convection Region Hazard Gauge

> NWS/SPC Severe Convection Region Hazard Gauge is a paid API for AI agents from aeml-x402.zeabur.app, paid per call via x402, $0.25/call, status unknown (last checked 2026-09-13).

Returns a real-time three-leg causal chain for a US severe convective storm region: forecast risk environment (SPC outlook + CAPE/CIN + wind shear), current NWS severe/tornado warnings, and SPC-verified storm reports (hail size, wind gusts, tornado counts) with crop/aviation/utility exposure.

## Facts

- Endpoint: GET https://aeml-x402.zeabur.app/gauge/severe-convection-region
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nws-spc-severe-convection-region-hazard-gauge-2a8b9268
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hQfmhaUSBZle_lI72Bzj2

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 nws-spc-severe-convection-region-hazard-gauge-2a8b9268
```

Example prompt: Pull the full severe convection hazard picture for tornado-alley-core — I need the SPC day-1 outlook, current CAPE/wind shear, any active NWS severe or tornado warnings, and what hail sizes and tornado counts have actually been reported so far today, plus how that maps to crop and aviation exposure.

## When to prefer this

Choose this endpoint when you need a single-call, officially-sourced, cross-validated severe convective storm hazard picture for a specific US region — combining upstream forecast environment, live warnings, and downstream storm verification. Preferred over raw NWS/SPC APIs when you need the three-leg causal chain pre-assembled with provenance and freshness metadata, and when the use case is property/crop/parametric insurance screening, agricultural logistics, aviation dispatch, or utility risk monitoring. Not appropriate for emergency shelter-in-place decisions or life-safety guidance.

## Known failure modes

- Entity key not recognized — returns error if ?entity= value does not match a supported convective region
- NWS/SPC source lag — data_age_hours may be elevated during source outages, flagged as stale in freshness field
- No active warnings or reports — legs return null or empty arrays when no severe weather is occurring in the region
- Payment not received — x402 micropayment required; unpaid requests return 402 status
- Region out of scope — only US convective regions supported; non-US entities return error

## How this service works

[3-LEG] Severe convection and hail chain, one convective region (?entity=tornado-alley-core): leading SPC Day-1 outlook with CAPE, CIN and shear - hours of lead -> current current storm reports -> realized realized hail and wind damage reports (confirmation gate). A sequential chain, not one reading - confidence = how many legs are lit, in order. Sources: NOAA SPC. Descriptive only, never a forecast or advice. No data -> 422 no_charge, not billed.

## Output

A structured JSON object containing: (1) forecast risk environment leg with SPC day-1 outlook, CAPE, CIN, and wind shear values; (2) current warnings leg with active NWS severe/tornado warnings and PDS watches; (3) storm reports leg with SPC-verified hail sizes, wind gusts, and tornado counts plus crop/aviation/utility exposure scores; (4) a cross-line narrative describing causal relationships; (5) provenance metadata including data age, freshness status, and traceable source citations; (6) a grade disclosure indicating screening-level data not suitable for emergency decisions.

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "entity"
     ],
     "properties": {
      "entity": {
       "type": "string",
       "examples": [
        "tornado-alley-core",
        "tx-panhandle-hail",
        "central-kansas",
        "high-plains-hail-alley",
        "front-range-co",
        "northern-plains"
       ],
       "description": "required - monitored object id, paired with signal_id; free list at GET /gauge/catalog?signal_id=<signal_id> -> signals[0].entities[]",
       "x-accepted-values": {
        "all": "https://api.truthbear.co/schemas/gauge-severe-convection-region.input.json",
        "shown": 6,
        "total": 16
       }
      }
     },
     "additionalProperties": false
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "const": "json"
    },
    "example": {}
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nws-spc-severe-convection-region-hazard-gauge-2a8b9268/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from aeml-x402.zeabur.app](https://www.zero.xyz/host/aeml-x402.zeabur.app/llms.txt)