# TruthBear Wildfire Region Gauge

> TruthBear Wildfire Region Gauge 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-15).

Returns a 3-leg sequential wildfire risk chain for a US/Canada fire region: leading fire weather conditions → active NASA FIRMS satellite fire detections → EPA downwind smoke impact confirmation.

## Facts

- Endpoint: GET https://api.truthbear.co/gauge/wildfire-region
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/truthbear-wildfire-region-gauge-8604e44a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oVQGQ8a9yovaOie24UVcN

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-wildfire-region-gauge-8604e44a
```

Example prompt: What's the current wildfire risk situation for California — check fire weather, active satellite fire detections, and smoke impact all at once and tell me how many of the three risk legs are lit.

## When to prefer this

Choose this endpoint when you need a multi-signal, sequentially-gated wildfire risk assessment for a specific US or Canadian fire region in a single call, combining fire weather, satellite fire detections, and smoke impact into one confidence-scored chain. Prefer this over raw satellite or weather APIs when you want cross-source confirmation rather than a single data point, and when you need descriptive current-state information (not a forecast or advisory).

## Known failure modes

- 422 no_charge: no data available for the requested entity at call time — not billed
- Invalid entity ID returns an error; valid entity IDs can be retrieved from GET /gauge/catalog?signal_id=<signal_id>
- Network or upstream source (NASA FIRMS, NWS, EPA) outage may result in partial or no data
- Requesting a region not in the supported entity list (12 total) returns an error

## How this service works

[3-LEG] Wildfire chain, one fire-risk region (?entity=us-california): leading fire weather - hot, dry and windy -> current active fire detections from NASA FIRMS satellite thermal anomalies -> realized downwind smoke impact (confirmation gate). A chain, not one reading: confidence = how many legs are lit, in order. Sources: NASA FIRMS, NWS, EPA. Descriptive only, never a forecast or advice. No data -> 422 no_charge, not billed. $0.25 per call.

## Output

A JSON object describing the three sequential wildfire chain legs: (1) fire weather conditions (hot, dry, windy from NWS), (2) active fire detections from NASA FIRMS satellite thermal anomalies, and (3) realized downwind smoke impact from EPA data. Confidence reflects how many legs are consecutively lit (0–3). If no data is available, returns HTTP 422 with no_charge and the call is not billed.

## 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": [
        "us-california",
        "us-pacific-northwest",
        "us-southwest",
        "us-rockies",
        "canada-bc",
        "canada-alberta"
       ],
       "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-wildfire-region.input.json",
        "shown": 6,
        "total": 12
       }
      }
     },
     "additionalProperties": false
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "const": "json"
    },
    "example": {}
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "legs": {
   "active_fire": {
    "band": "none",
    "source_ref": "https://firms.modaps.eosdis.nasa.gov/",
    "record_hash": "sha256:53ba632b9385ff7063f142a3701331a2d872adc3c4c5e3848845880cb8ed7f4c"
   },
   "fire_weather": {
    "band": "watch",
    "source_ref": "https://open-meteo.com/",
    "record_hash": "sha256:2f291a31f09b82bfdbe5ab2c8b1ad0ca11564c153717a0ea5986c7c71ba9b3fb"
   },
   "impact_confirm": {
    "band": "clear",
    "source_ref": "https://open-meteo.com/en/docs/air-quality-api",
    "record_hash": "sha256:8ab51e767535b4fb7a43cbf1eac45db2261d0653b8e749b7d03b5df9c5bc0ccf"
   }
  },
  "name": "US California",
  "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": 39,
   "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-wildfire-region-gauge-8604e44a/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)