{"uid":"cap_lJA6jPZrqyYR8ft-HO_6c","slug":"truthbear-gauge-single-signal-current-reading-d6008efc","name":"TruthBear Gauge – Single Signal Current Reading","description":"[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.","url":"https://api.truthbear.co/gauge","method":"GET","headers":{},"bodySchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["signal_id","entity"],"properties":{"entity":{"type":"string","examples":["07010000"],"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[]"},"signal_id":{"type":"string","examples":["hydrology.river-level"],"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"}},"additionalProperties":false}}},"output":{"type":"object","required":["type"],"properties":{"type":{"const":"json"},"example":{}}}}},"responseSchema":{"type":"json","example":{"grade":"screening-level, not decision-grade","scope":{"full":"https://api.truthbear.co/scope/v1","verifiability":"via-endpoint","monitoring_not_forecast":true,"intelligence_not_command":true},"entity":"03255000","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.","current":{"gauge_height_ft":30.69},"signal_id":"hydrology.river-level","provenance":{"freshness":"fresh","age_hours_now":23,"freshness_basis":"cadence=daily; fresh<=24h; recent<=192h; dead_source>1440h; age_basis=request-time(now minus observed_at)"},"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.","entity_name":"Ohio River at Cincinnati, OH","observed_at":"2026-08-25T04:00:00.000Z","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."}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_2kwaVHrLpZAMC5wlvUlTt","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the current reading for a specific signal/entity pair, benchmarked against official thresholds (band, distance-to-action) and a 5-year same-season percentile, across 180+ signals spanning macro, weather, hazard, shipping, filings, crypto, and lifecycle domains.","exampleAgentPrompt":"What is the current river level reading for gauge station 07010000 on the hydrology.river-level signal — is it in the normal band or approaching an action threshold, and how does it compare to the same time of year historically?","exampleUseCases":[{"title":"Flood risk monitoring for infrastructure","prompt":"Pull the current hydrology.river-level reading for station 07010000 — tell me what band it's in, how far it is from the next action threshold, and whether this level is unusual for this time of year based on the last 5 years."},{"title":"Macro signal anomaly check for investment research","prompt":"Get me the current macro.unemployment reading for the US — is it above or below the official warning threshold, and is this level routine or historically elevated for this season?"},{"title":"Crypto signal baseline check for risk dashboard","prompt":"What's the current crypto.spot signal reading for Bitcoin? I want to know which threshold band it's in and where it sits in the 5-year same-season percentile so I can tell if this is an unusual moment or business as usual."}],"resultDescription":"A JSON object containing the current scalar reading for the requested signal/entity pair, its placement within the official threshold ladder (band label and distance-to-action), and a 5-year same-season percentile indicating whether the reading is routine or anomalous. Returns a 422 no_charge error if no data is available for the requested pair, so you are not billed for missing data.","failureModes":["422 no_charge: No data available for the requested signal_id/entity pair — not billed","Invalid signal_id format (must be genus.species ASCII form) causes rejection","Invalid or unrecognized entity identifier for the given signal_id","Mismatched signal_id/entity pair not in the catalog causes failure — use /gauge/catalog to validate pairs first","Network or provider timeout resulting in no response"],"whenToPreferThis":"Use this endpoint when you need a single authoritative current-state snapshot for a specific signal and entity, with threshold-relative context (band, distance-to-action) and seasonal historical framing (5-year percentile). Prefer it over the history-series endpoint when you want the present reading rather than a time series, and over the calibrated add-on when raw (not normalized) readings are sufficient. Always check /gauge/coverage or /gauge/catalog first to confirm the signal_id/entity pair is valid and avoid unbillable 422 errors.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T06:50:21.986Z","isFirstParty":false}