{"uid":"cap_YXL1sXFSFU7qpn4ncM8kk","slug":"truthbear-gauge-region-environmental-chain-90a3b1e5","name":"TruthBear Gauge/Region Environmental Chain","description":"[3-LEG] Local three-leg environment chain, one location (?loc=): leading air quality (AQI) -> current precipitation, rain and 30-day dry-wet -> realized nearest river stage and streamflow (confirmation gate). A chain, not one reading: confidence = how many legs are lit, in order. Sources: EPA/CAMS, ERA5, USGS. Descriptive only, never a forecast or advice. No data -> 422 no_charge, not billed. $0.25 per call.","url":"https://api.truthbear.co/gauge/region","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":["loc"],"properties":{"loc":{"type":"string","examples":["us-stlouis","us-memphis","us-losangeles","us-fresno","us-phoenix","us-denver"],"description":"required - location id; full list at free /gauge/preview","x-accepted-values":{"all":"https://api.truthbear.co/schemas/gauge-region.input.json","shown":6,"total":12}}},"additionalProperties":false}}},"output":{"type":"object","required":["type"],"properties":{"type":{"const":"json"},"example":{}}}}},"responseSchema":{"type":"json","example":{"legs":{"air":{"airquality.aqi":{"band":"below_moderate","source_ref":"https://open-meteo.com/en/docs/air-quality-api(Copernicus CAMS)","record_hash":"sha256:614778264bba65021acbc1bf522d5f2b4f22599190614bed03c2139a96bd7a31"},"airquality.pm25":{"band":"below_moderate","source_ref":"https://open-meteo.com/en/docs/air-quality-api(Copernicus CAMS)","record_hash":"sha256:2df3210c2a75ac7b1e5652c45649b7d1d3014400338096edd32d3f0afe1e330d"}},"river":{"band":"below_action","source_ref":"https://waterdata.usgs.gov/monitoring-location/07010000/","record_hash":"sha256:a3986d8689a1d9f6e8b4b92c2318d5af64291cdedbdbd3d706e0049e16fcb42e"},"precipitation":{"precipitation.daily":{"band":"below_moderate","source_ref":"https://open-meteo.com/en/docs(ECMWF / archive ERA5)","record_hash":"sha256:011f2bf5882fc9bdef3eb11a4ad2fadb13e99edc45e1628efed88d899715cb53"},"precipitation.wetness30d":{"band":"unrated","source_ref":"https://open-meteo.com/en/docs(ECMWF / archive ERA5)","record_hash":"sha256:cecdb2c3f4fe8e3c7bbf73b735b99d0396fb19564cbe6c80cb09dde3ef3fa1f8"}}},"name":"St. Louis, MO","grade":"screening-level, not decision-grade","scope":{"full":"https://api.truthbear.co/scope/v1","verifiability":"unknown","monitoring_not_forecast":true,"intelligence_not_command":true},"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.","location":"us-stlouis","provenance":{"freshness":"fresh","age_hours_now":15,"freshness_basis":"cadence=default; fresh<=24h; recent<=192h; dead_source>1440h; age_basis=request-time(now minus observed_at)"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","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.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Vmrh1bCFPlSA_FDFmLRt6","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Runs a sequential three-leg local environment chain (air quality AQI → precipitation/dry-wet → river stage/streamflow) for a single location, returning confidence based on how many legs return data.","exampleAgentPrompt":"Can you pull the full three-leg environmental chain for Austin, Texas — air quality index, recent precipitation and dry-wet status, and the nearest river stage and streamflow — and tell me how many legs came back with data?","exampleUseCases":[{"title":"Pre-event outdoor air and water check","prompt":"Before our outdoor festival this weekend near Sacramento, CA, can you check the current AQI, how wet or dry the last 30 days have been, and whether any nearby rivers are running unusually high?"},{"title":"Flood-risk context for a property","prompt":"I'm looking at a property near Nashville, TN — can you run the environmental chain for that area and tell me the current river stage and streamflow, plus whether precipitation has been heavy lately?"},{"title":"Environmental baseline for field research","prompt":"We're doing field sampling near Baton Rouge, LA next week — can you get the current air quality, precipitation trend, and nearest river gauge reading so we have a baseline before we go?"}],"resultDescription":"A sequential three-leg environmental report for the given location: (1) leading air quality AQI from EPA/CAMS, (2) current precipitation and 30-day dry-wet status from ERA5, (3) nearest river stage and streamflow from USGS as a confirmation gate. Confidence is expressed as the number of legs that returned data (0–3). If no data is available for any leg, returns HTTP 422 with a no_charge code and is not billed. The response is descriptive only — no forecasts or advice are provided.","failureModes":["422 no_charge: no data available for any leg at the given location — call is not billed","Invalid or unrecognized location parameter returns an error","Partial data: one or two legs lit, confidence score reflects available legs only","Network timeout reaching upstream sources (EPA/CAMS, ERA5, USGS)","Location outside coverage area for one or more upstream sources"],"whenToPreferThis":"Choose this endpoint when you need a corroborated, multi-source environmental snapshot — air quality, precipitation history, and river hydrology — for a single location in one call. It is ideal when you want confidence-weighted environmental context rather than a single reading, and when you need data provenance from authoritative sources (EPA, ERA5, USGS). Prefer it over single-variable APIs when the use case requires cross-domain environmental confirmation (e.g., flood risk, outdoor safety, field research baseline). It is not suitable for forecasting or advisory outputs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:48:25.744Z","isFirstParty":false}