# TruthBear Drought Region 3-Leg Chain

> TruthBear Drought Region 3-Leg Chain 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 sequential three-leg drought assessment for a US region: precipitation deficit and soil moisture leading indicators, current USDM official drought class and coverage, and streamflow/impact confirmation.

## Facts

- Endpoint: GET https://api.truthbear.co/gauge/drought-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/truthbear-drought-region-3-leg-chain-b5f24b77
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0hXbVTLzKAZqIiNyQg7dX

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 truthbear-drought-region-3-leg-chain-b5f24b77
```

Example prompt: What's the current drought situation in California — pull the official USDM drought class, how much of the state is affected, and whether soil moisture and streamflow are confirming it?

## When to prefer this

Choose this endpoint when you need an authoritative, multi-source drought assessment that combines USDM official classifications with leading hydrological indicators (soil moisture, snowpack, precipitation deficit) and confirms with realized streamflow data. Prefer this over a simple weather or precipitation endpoint when you need drought severity classification, area coverage, and impact confirmation in a single structured call. Best for agents monitoring water stress, agricultural risk, or regional environmental conditions in the US.

## Known failure modes

- 422 no_charge returned when no data is available for the requested entity — not billed
- Invalid or unrecognized entity ID results in an error; use GET /gauge/catalog?signal_id=<signal_id> to retrieve valid entity list
- Partial data may reduce confidence score if only some legs return data
- Network or upstream USDM/USGS outage may delay or prevent data retrieval

## How this service works

[3-LEG] Drought chain, one drought region (?entity=us-california): leading precipitation deficit, soil moisture and snowpack -> current the OFFICIAL US Drought Monitor class and area coverage -> realized streamflow and impact (confirmation gate). A chain, not one reading: confidence = how many legs are lit, in order. Sources: USDM/NDMC, USGS. Descriptive only, never a forecast or advice. No data -> 422 no_charge, not billed. $0.25 per call.

## Output

A sequential three-part drought assessment JSON object containing: (1) leading indicators — precipitation deficit, soil moisture, and snowpack status; (2) official USDM drought class (D0–D4) and percentage area coverage; (3) streamflow and realized impact as a confirmation gate. A confidence score reflects how many of the three legs returned valid data. Returns HTTP 422 with no charge if no data is available for the requested region.

## 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": [
        "us-california",
        "us-southwest",
        "us-southernplains",
        "us-northernplains",
        "us-cornbelt",
        "us-southeast"
       ],
       "x-accepted-values": {
        "shown": 6,
        "total": 10,
        "all": "https://api.truthbear.co/schemas/gauge-drought-region.input.json"
       }
      }
     },
     "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": {
   "status": {
    "band": "D0-abnormally-dry",
    "source_ref": "https://droughtmonitor.unl.edu/",
    "record_hash": "sha256:e69894d0ac7054f477bc1e62e906bc98be89ae3ceeb06aa71506be150fb0312a"
   },
   "impact_cascade": {
    "band": "emerging",
    "source_ref": "https://www.drought.gov/",
    "record_hash": "sha256:7ae14db69710e919ab1517129ef8dc347820b4b6b9402fa174c1ef195271ddb6"
   },
   "onset_pressure": {
    "band": "ED3-extreme-demand",
    "source_ref": "https://www.drought.gov/data-maps-tools/evaporative-demand-drought-index-eddi",
    "record_hash": "sha256:931c7e44e74d37b1eaf30f8fe08179882b621904f43e86772cc530bf0c577cca"
   },
   "season_timeline": {
    "band": "above-normal",
    "source_ref": null,
    "record_hash": null
   }
  },
  "name": "US — California (evaporative-demand onset)",
  "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": "us-california",
  "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": "recent",
   "age_hours_now": 156,
   "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/truthbear-drought-region-3-leg-chain-b5f24b77/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)
