Truth Bear · Gauge Shipping 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/shipping-region", {
  method: "GET",
});
const data = await res.json();

curl -X GET \
  "https://api.truthbear.co/gauge/shipping-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": {
    "route_disruption": {
      "band": "operable",
      "record_hash": "sha256:713b0c84338039b1860da52058d9089cc1f2b32404a575bf3d5a550023bf0cb9",
      "source_ref": "https://open-meteo.com/en/docs/marine-weather-api"
    },
    "sea_state": {
      "band": null,
      "record_hash": "sha256:a69ae225e6aa376b3bfa3d9e9a8dd435783ca62c149e599621be7f311ca1e329",
      "source_ref": "https://open-meteo.com/en/docs/marine-weather-api"
    },
    "throughput": {
      "band": "no-coverage",
      "record_hash": "sha256:ae1dd2720dd4ae4d8ca046122b1e250d5646968a1cf5aec3af06d4e179bffa1e",
      "source_ref": "https://aisstream.io/documentation"
    }
  },
  "location": "suez-redsea",
  "name": "Suez / Red Sea approach",
  "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": 15,
    "freshness": "fresh",
    "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"
  }
}