Truth Bear · Gauge Grid Region

import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPay("https://api.truthbear.co/gauge/grid-region", {
  method: "GET",
});
const data = await res.json();

curl -X GET \
  "https://api.truthbear.co/gauge/grid-region?loc=required+-+location+id%3B+full+list+at+free+%2Fgauge%2Fpreview" \
  -H "X-PAYMENT: <signed x402 payment>"

{
  "grade": "screening-level, not decision-grade",
  "legs": {
    "demand": {
      "band": "high",
      "record_hash": "sha256:79a8543f6b4562e0e8111abb50fff64a00c167630bd277b717cf56f446f5011a",
      "source_ref": "https://open-meteo.com/en/docs (temperature -> HDD/CDD base 18 degC)"
    },
    "energy_inflation": {
      "band": "extreme",
      "record_hash": "sha256:e7eecf1126e1e2b5f5f8dcbb629e1c45051edbd371c4d6e6eada3d9eabdef29d",
      "source_ref": "https://fred.stlouisfed.org/series/CPIENGSL"
    },
    "gas_price": {
      "band": "low",
      "record_hash": "sha256:de4087d873ff105bde0abac04dbc552bc715bcdb42a1c3c82a2eea8d08031727",
      "source_ref": "https://fred.stlouisfed.org/series/DHHNGSP"
    },
    "renewable": {
      "band": "extreme",
      "record_hash": "sha256:b740795bd6c729dc1451da0169fb59f638ed98e0c35fecc7c8df7aa1e095df72",
      "source_ref": "https://open-meteo.com/en/docs (shortwave_radiation+wind_speed -> CF proxy)"
    }
  },
  "location": "us-ercot",
  "name": "US - ERCOT (Texas)",
  "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": {
    "age_hours_now": 2079,
    "dead_source": true,
    "freshness": "stale",
    "freshness_basis": "cadence=default; fresh<=24h; recent<=192h; dead_source>1440h; age_basis=request-time(now minus observed_at)"
  },
  "scope": {
    "full": "https://api.truthbear.co/scope/v1",
    "intelligence_not_command": true,
    "monitoring_not_forecast": true,
    "verifiability": "unknown"
  }
}