{"uid":"cap_YZSPi2aoEeXp0yhkuClKl","slug":"truthbear-gauge-census-ff5b7780","name":"TruthBear Gauge Census","description":"[BATCH+PROOF] All entities for one signal at their latest reading, with band, frequency_label and percentile columns so you can rank across stations and screen for the unusual in one call. Cross-station comparison is the point: one river gauge alone tells you little, 200 of them ranked by distance-to-action tells you a lot. Descriptive only, never a forecast or advice. No data -> 422 no_charge, not billed. $0.09 per call.","url":"https://api.truthbear.co/gauge/census","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"],"properties":{"signal_id":{"type":"string","examples":["hydrology.river-level"],"description":"required - signal id (genus.species); free list at GET /gauge/catalog (paged; ?all=1 for every line)"}},"additionalProperties":false}}},"output":{"type":"object","required":["type"],"properties":{"type":{"const":"json"}}}}},"responseSchema":{"type":"json"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.09","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.09/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.09","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.09","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_h21XR_xXNZY1XeEsGWV26","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.09","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the latest reading for all entities under a given signal, ranked and annotated with band, frequency label, and percentile for cross-station comparison.","exampleAgentPrompt":"Pull a full ranked census for the hydrology.river-level signal — I want to see all stations with their band, percentile, and how close each is to action stage so I can spot any unusual ones.","exampleUseCases":[{"title":"Flood watch triage across a river basin","prompt":"Show me all river gauge stations for hydrology.river-level ranked by percentile so I can quickly see which ones are closest to or above action stage right now."},{"title":"Screening for unusual environmental readings","prompt":"Run a cross-station census for the hydrology.river-level signal and highlight any stations that are in an elevated or abnormal band compared to the rest of the network."},{"title":"Building a river risk dashboard","prompt":"I need a snapshot of every station's latest reading, band, and percentile for hydrology.river-level in one call so I can populate a live risk ranking table for our monitoring dashboard."}],"resultDescription":"A batch JSON response listing every entity (station) tracked under the requested signal, each annotated with its latest reading value, band classification (e.g. normal/elevated/action), frequency label, and percentile rank — enabling immediate cross-station comparison and screening for outliers. Returns a 422 no_charge error if no data is available.","failureModes":["422 no_charge: no data available for the requested signal — not billed","Invalid or unknown signal_id returns an error (signal not found in catalog)","Missing required signal_id parameter causes a validation error","Network timeout if the station count is very large"],"whenToPreferThis":"Choose this endpoint when you need a single-call snapshot of ALL entities (stations) for a given signal, ranked by percentile and annotated with band and frequency metadata. It is the right choice for cross-station screening, anomaly detection, and risk triage at scale. Prefer it over gauge/history-series (which returns time series for one station) or gauge/calibrated (which adds calibrated units for one entity) when the goal is comparative ranking across the full network rather than deep analysis of a single location.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T17:53:22.185Z","isFirstParty":false}