[SIGNAL+PROOF] One official signal record for any signal_id and entity: current reading ag
[SIGNAL+PROOF] One official signal record for any signal_id and entity: current reading against the OFFICIAL threshold ladder (band, distance-to-action) plus a 5-year same-season percentile so you can tell routine from unusual. 180+ signals across macro, weather, hazard, shipping, filings, crypto and lifecycle lines. Free coverage check first at /gauge/coverage. Descriptive only, never a forecast or advice. No data -> 422 no_charge, not billed. $0.01 per call.
10000 (raw units)
price
29
calls / 30d
2
unique payers
2026-09-07
updated
Provider
api.truthbear.co · discovered, not yet claimed by its owner
Payment (x402 accepts[])
[
{
"scheme": "exact",
"network": "eip155:8453",
"payTo": "0x2d16a243ba9facc6ac85519d5efad2149dc4c6c3",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "10000",
"maxTimeoutSeconds": 300
},
{
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"payTo": "8qEn3Y3GPXdQ28LHshPa4UYeD8V38Lq9b4jCRirQAY3n",
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"amount": "10000",
"maxTimeoutSeconds": 300
}
]Output schema
{
"bazaar": {
"discoverable": true,
"info": {
"input": {
"example": {
"entity": "07010000",
"format": "thin",
"signal_id": "hydrology.river-level"
},
"exampleRequest": "/gauge?signal_id=hydrology.river-level&entity=07010000&format=thin",
"method": "GET",
"queryParams": {
"entity": "required - monitored object id, PAIRED WITH signal_id (e.g. 07010000 for hydrology.river-level, japan for earthquake.cur",
"signal_id": "required - signal id in genus.species ASCII form (e.g. hydrology.river-level, crypto.spot, macro.unemployment, earthquak"
},
"type": "http"
},
"output": {
"example": {
"current": {
"gauge_height_ft": 30.69
},
"entity": "03255000",
"entity_name": "Ohio River at Cincinnati, OH",
"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-25T04:00:00.000Z",
"provenance": {
"age_hours_now": 23,
"freshness": "fresh",
"freshness_basis": "cadence=daily; fresh<=24h; recent<=192h; dead_source>1440h; age_basis=request-time(now minus observed_at)"
},
"record_hash": "sha256:5969b8a147f438254edadf246ed1d7801a77c29babb5d725e17870320d620dd7",
"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/03255000/",
"summary_en": "Ohio River at Cincinnati, OH: 30.69 ft gauge height - no flooding, 9.31 ft below the first official alert (action stage 40 ft). seasonal percentile 0.922 (rare). falling vs 24h ago."
},
"type": "json"
}
},
"outputSchemaRef": "/manifest",
"priceUsd": "$0.01",
"priceUsdNumber": 0.01,
"routeTemplate": "/gauge",
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"properties": {
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"additionalProperties": false,
"properties": {
"entity": {
"description": "required - monitored object id, PAIRED WITH signal_id (e.g. 07010000 for hydrology.river-level, japan for earthquake.current_activity). Valid pairs: free GET /gauge/catalog?signal_id=<signal_id> -> signals[0].entities[]",
"examples": [
"07010000"
],
"type": "string"
},
"signal_id": {
"description": "required - signal id in genus.species ASCII form (e.g. hydrology.river-level, crypto.spot, macro.unemployment, earthquake.current_activity). Full list: free GET /gauge/catalog",
"examples": [
"hydrology.river-level"
],
"type": "string"
}
},
"required": [
"signal_id",
"entity"
],
"type": "object"
},
"type": {
"const": "http"
}
},
"required": [
"type",
"method",
"queryParams"
],
"type": "object"
},
"output": {
"properties": {
"example": {},
"type": {
"const": "json"
}
},
"required": [
"type"
],
"type": "object"
}
}
}
}
}Use it
curl
curl "https://api.truthbear.co/gauge" # -> 402 Payment Required, accepts[] lists how to pay # retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid
JavaScript
const res = await fetch("https://api.truthbear.co/gauge");
if (res.status === 402) {
const { accepts } = await res.json();
// pay one of accepts[] via an x402 client, then retry with the payment header
}Python
import httpx
res = httpx.get("https://api.truthbear.co/gauge")
if res.status_code == 402:
accepts = res.json()["accepts"]
# pay one of accepts[] via an x402 client, then retry with the payment headerMachine-readable
Everything on this page is also available as clean JSON at /resources/4449.json, and this resource appears in /discovery/resources and /discovery/search.