# Hurricane Basin Status Chain (NHC Official)

> Hurricane Basin Status Chain (NHC Official) is a paid API for AI agents from api.truthbear.co, paid per call via x402, $0.25/call, status unknown (last checked 2026-09-14).

Returns a 3-leg sequential chain of NHC-official hurricane data for one basin: genesis probability, active storm details, and official watches/warnings/landfall confirmations.

## Facts

- Endpoint: GET https://api.truthbear.co/gauge/hurricane-region
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hurricane-basin-status-chain-nhc-official-d9e6c542
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_L8m7FG5XvlAXZnNrccjlA

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 hurricane-basin-status-chain-nhc-official-d9e6c542
```

Example prompt: Pull the current NHC hurricane chain for the Atlantic basin — I want the official genesis probabilities, any active storm details like category and position, and any watches or warnings in effect.

## When to prefer this

Choose this endpoint when you need official NHC-sourced hurricane basin status in a structured 3-leg chain format — genesis probability, active storm telemetry, and watch/warning/landfall confirmation — for one of the three supported basins (Atlantic, Eastern Pacific, Central Pacific). Prefer this over general weather APIs when you specifically need tropical cyclone genesis probability quoted directly from NHC, or when you need to confirm official watches and warnings rather than model forecasts. The no_charge 422 on no-data makes it cost-safe to poll during quiet seasons.

## Known failure modes

- 422 no_charge returned when no data is available for the basin — agent is not billed
- Invalid entity value (not atlantic, epacific, or cpacific) results in an error
- Partial chain response if only some legs have data — confidence score reflects number of lit legs
- NHC data latency or outage may result in stale or missing leg data
- cpacific basin may have no active storms for long stretches, returning minimal data

## How this service works

[3-LEG] Hurricane chain, one basin (?entity=atlantic|epacific|cpacific): leading NHC official 2/7-day genesis probability (NHC-quoted, not our forecast) -> current active storms - category, wind, pressure, position -> realized official watches, warnings, landfall (confirmation gate). A chain, not one reading: confidence = how many legs are lit, in order. Sources: NOAA NHC. Descriptive only, never a forecast or advice. No data -> 422 no_charge, not billed. $0.25 per call.

## Output

A 3-leg sequential chain response: Leg 1 quotes the current NHC official 2-day and 7-day tropical cyclone genesis probabilities for the requested basin. Leg 2 lists currently active named storms with their category, maximum sustained wind, minimum pressure, and current position. Leg 3 provides realized official watches, warnings, and landfall confirmation events. Confidence in the reading is indicated by how many legs return data. Returns 422 with no_charge if no data is available for the basin.

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "type": "string",
     "enum": [
      "GET"
     ]
    },
    "queryParams": {
     "type": "object",
     "additionalProperties": false,
     "properties": {
      "entity": {
       "type": "string",
       "description": "required - monitored object id, paired with signal_id; free list at GET /gauge/catalog?signal_id=<signal_id> -> signals[0].entities[]",
       "examples": [
        "atlantic",
        "epacific",
        "cpacific"
       ]
      }
     },
     "required": [
      "entity"
     ]
    }
   },
   "required": [
    "type",
    "method",
    "queryParams"
   ]
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "const": "json"
    },
    "example": {}
   },
   "required": [
    "type"
   ]
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "legs": {
   "active_storms": {
    "band": "none",
    "source_ref": "https://www.nhc.noaa.gov/cyclones/",
    "record_hash": "sha256:dca1edeb7ee415a64e2c940922b1c857dbcd503da04bd155cd9bd3471bb4ff6f"
   },
   "impact_cascade": {
    "band": "none",
    "source_ref": "https://www.nhc.noaa.gov/surge/warning/",
    "record_hash": "sha256:55d0bc6227559e6b1ac85525a358d905226994f8c08acc0562a8acc83ddd54fa"
   },
   "season_timeline": {
    "band": "above-normal",
    "source_ref": "https://www.nhc.noaa.gov/data/",
    "record_hash": "sha256:29c038da3b62eda95f54cef7f5762ddf7efe9a21df4371c0839cc26a08f1ad2f"
   },
   "formation_outlook": {
    "band": "none",
    "source_ref": "https://www.nhc.noaa.gov/gtwo.php",
    "record_hash": "sha256:d7ce15ac10d971218ddeff358bd9c24276f27b29f12c7db235a2744033c4a1a6"
   }
  },
  "name": "Atlantic basin (formation outlook)",
  "grade": "screening-level, not decision-grade",
  "scope": {
   "full": "https://api.truthbear.co/scope/v1",
   "verifiability": "unknown",
   "monitoring_not_forecast": true,
   "intelligence_not_command": true
  },
  "entity": "atlantic",
  "nature": "This API supplies data organisation and trend description only. It is not a recommendation to act; the decision is yours. Purely descriptive - no judgement, no prediction. Official source plus record_hash; verify with the free /gauge/verify.",
  "provenance": {
   "freshness": "stale",
   "age_hours_now": 610,
   "freshness_basis": "cadence=default; fresh<=24h; recent<=192h; dead_source>1440h; age_basis=request-time(now minus observed_at)"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hurricane-basin-status-chain-nhc-official-d9e6c542/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.truthbear.co](https://www.zero.xyz/host/api.truthbear.co/llms.txt)