# TruthBear Grid-Region Gauge

> TruthBear Grid-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-14).

Returns a 3-leg sequential chain analysis of power-grid stress for a specified grid region, covering demand pressure (HDD/CDD), renewable availability (solar/wind), and realized energy inflation (CPI + gas price confirmation), with a confidence score based on how many legs are data-lit.

## Facts

- Endpoint: GET https://api.truthbear.co/gauge/grid-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-grid-region-gauge-8d254d71
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__RYvPONAZh_3neHpBdqqQ

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-grid-region-gauge-8d254d71
```

Example prompt: Pull the TruthBear grid-region gauge for ERCOT — I want to see demand pressure from heating and cooling degree days, current solar and wind availability, and where realized energy CPI and gas prices stand, plus the confidence score for how many legs are lit.

## When to prefer this

Use this endpoint when you need a multi-factor, sequential chain assessment of a specific power grid region that combines weather-derived demand signals, real-time renewable availability, and realized macroeconomic energy inflation data in one call. Prefer this over single-signal energy APIs when you need corroborating confirmation across demand, supply, and inflation legs with an explicit confidence score. Best suited for energy market research, grid risk monitoring, or ESG/sustainability analysis by region. Not appropriate when you need raw forecast data, trading signals, or financial advice.

## Known failure modes

- 422 no_charge: no data available for requested grid region or legs — call is not billed
- Invalid loc parameter: unrecognized or unsupported grid region ID
- Missing required loc query parameter returns validation error
- Upstream data source (EIA, BLS, Open-Meteo) unavailability may reduce confidence score or trigger 422

## How this service works

[3-LEG] Power-grid chain, one grid region (?loc=us-ercot): leading demand pressure from heating and cooling degree days -> current renewable availability, solar and wind -> realized energy inflation (CPI energy year-over-year) and gas price (confirmation gate). A chain, not one reading: confidence = how many legs are lit, in order. Sources: EIA, BLS, Open-Meteo. Descriptive only, never a forecast or advice. No data -> 422 no_charge, not billed. $0.25 per call.

## Output

A structured JSON response containing the 3-leg sequential chain: (1) demand pressure derived from heating and cooling degree days, (2) current renewable availability including solar and wind figures, (3) realized energy inflation as CPI energy year-over-year and gas price as a confirmation gate. Also returns a confidence indicator reflecting how many of the three legs have live data. Returns 422 no_charge if no data is available (not billed). Descriptive only — no forecast or investment advice.

## 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": {
      "loc": {
       "type": "string",
       "description": "required - location id; full list at free /gauge/preview",
       "examples": [
        "us-ercot",
        "us-caiso",
        "us-pjm",
        "us-miso",
        "us-nyiso",
        "eu-germany"
       ],
       "x-accepted-values": {
        "shown": 6,
        "total": 12,
        "all": "https://api.truthbear.co/schemas/gauge-grid-region.input.json"
       }
      }
     },
     "required": [
      "loc"
     ]
    }
   },
   "required": [
    "type",
    "method",
    "queryParams"
   ]
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "const": "json"
    },
    "example": {}
   },
   "required": [
    "type"
   ]
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "legs": {
   "demand": {
    "band": "high",
    "source_ref": "https://open-meteo.com/en/docs (temperature -> HDD/CDD base 18 degC)",
    "record_hash": "sha256:79a8543f6b4562e0e8111abb50fff64a00c167630bd277b717cf56f446f5011a"
   },
   "gas_price": {
    "band": "low",
    "source_ref": "https://fred.stlouisfed.org/series/DHHNGSP",
    "record_hash": "sha256:de4087d873ff105bde0abac04dbc552bc715bcdb42a1c3c82a2eea8d08031727"
   },
   "renewable": {
    "band": "extreme",
    "source_ref": "https://open-meteo.com/en/docs (shortwave_radiation+wind_speed -> CF proxy)",
    "record_hash": "sha256:b740795bd6c729dc1451da0169fb59f638ed98e0c35fecc7c8df7aa1e095df72"
   },
   "energy_inflation": {
    "band": "extreme",
    "source_ref": "https://fred.stlouisfed.org/series/CPIENGSL",
    "record_hash": "sha256:e7eecf1126e1e2b5f5f8dcbb629e1c45051edbd371c4d6e6eada3d9eabdef29d"
   }
  },
  "name": "US - ERCOT (Texas)",
  "grade": "screening-level, not decision-grade",
  "scope": {
   "full": "https://api.truthbear.co/scope/v1",
   "verifiability": "unknown",
   "monitoring_not_forecast": true,
   "intelligence_not_command": true
  },
  "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.",
  "location": "us-ercot",
  "provenance": {
   "freshness": "stale",
   "dead_source": true,
   "age_hours_now": 2079,
   "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-grid-region-gauge-8d254d71/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)