Truth Bear · Gauge Calibrated

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/calibrated", {
  method: "GET",
});
const data = await res.json();

curl -X GET \
  "https://api.truthbear.co/gauge/calibrated?entity=required+-+monitored+object+id%2C+paired+with+signal_id%3B+free+list+at+GET+%2Fgauge%2Fcatalog%3Fsignal_id%3D%3Csignal_id%3E+-%3E+signals%5B&signal_id=required+-+signal+id+%28genus.species%29%3B+free+list+at+GET+%2Fgauge%2Fcatalog+%28paged%3B+%3Fall%3D1+for+every+line%29" \
  -H "X-PAYMENT: <signed x402 payment>"

{
  "calibrated": {
    "band": "below_action",
    "current_value": 6.48,
    "index_basis": "normalized_index: piecewise linear (action=0/minor=1/moderate=2/major=3); below the first band = (value - first threshold) / first threshold, clamped to [-1,0); above the top band it is unbounded. pct_to_action = value / first alert threshold (bounded, 1 = at the first alert)",
    "metric": "gauge_height_ft",
    "normalized_index": -0.769,
    "pct_to_action": 0.231,
    "scale": "flood_stage",
    "unit": "ft"
  },
  "dim": "calibrated",
  "entity": "07010000",
  "entity_name": "Mississippi River at St. Louis, MO",
  "grade": "screening-level, not decision-grade",
  "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.",
  "observed_at": "2026-08-26T09:30:00.000Z",
  "provenance": {
    "age_hours_now": 5.5,
    "freshness": "fresh",
    "freshness_basis": "cadence=daily; fresh<=24h; recent<=192h; dead_source>1440h; age_basis=request-time(now minus observed_at)"
  },
  "record_hash": "sha256:a3986d8689a1d9f6e8b4b92c2318d5af64291cdedbdbd3d706e0049e16fcb42e",
  "record_hash_verifiable": {
    "mode": "via-endpoint",
    "note": "This response is a projected delivery (some core fields are omitted to control size). Cross-check record_hash with the free /gauge/verify, or buy /gauge to get the complete core for offline recomputation."
  },
  "scope": {
    "full": "https://api.truthbear.co/scope/v1",
    "intelligence_not_command": true,
    "monitoring_not_forecast": true,
    "verifiability": "via-endpoint"
  },
  "signal_id": "hydrology.river-level",
  "source_ref": "https://waterdata.usgs.gov/monitoring-location/07010000/"
}