{"uid":"cap_0hXbVTLzKAZqIiNyQg7dX","slug":"truthbear-drought-region-3-leg-chain-b5f24b77","name":"TruthBear Drought Region 3-Leg Chain","description":"[3-LEG] Drought chain, one drought region (?entity=us-california): leading precipitation deficit, soil moisture and snowpack -> current the OFFICIAL US Drought Monitor class and area coverage -> realized streamflow and impact (confirmation gate). A chain, not one reading: confidence = how many legs are lit, in order. Sources: USDM/NDMC, 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/drought-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":["entity"],"properties":{"entity":{"type":"string","examples":["us-california","us-southwest","us-southernplains","us-northernplains","us-cornbelt","us-southeast"],"description":"required - monitored object id, paired with signal_id; free list at GET /gauge/catalog?signal_id=<signal_id> -> signals[0].entities[]","x-accepted-values":{"all":"https://api.truthbear.co/schemas/gauge-drought-region.input.json","shown":6,"total":10}}},"additionalProperties":false}}},"output":{"type":"object","required":["type"],"properties":{"type":{"const":"json"},"example":{}}}}},"responseSchema":{"type":"json","example":{"legs":{"status":{"band":"D0-abnormally-dry","source_ref":"https://droughtmonitor.unl.edu/","record_hash":"sha256:e69894d0ac7054f477bc1e62e906bc98be89ae3ceeb06aa71506be150fb0312a"},"impact_cascade":{"band":"emerging","source_ref":"https://www.drought.gov/","record_hash":"sha256:7ae14db69710e919ab1517129ef8dc347820b4b6b9402fa174c1ef195271ddb6"},"onset_pressure":{"band":"ED3-extreme-demand","source_ref":"https://www.drought.gov/data-maps-tools/evaporative-demand-drought-index-eddi","record_hash":"sha256:931c7e44e74d37b1eaf30f8fe08179882b621904f43e86772cc530bf0c577cca"},"season_timeline":{"band":"above-normal","source_ref":null,"record_hash":null}},"name":"US — California (evaporative-demand onset)","grade":"screening-level, not decision-grade","scope":{"full":"https://api.truthbear.co/scope/v1","verifiability":"unknown","monitoring_not_forecast":true,"intelligence_not_command":true},"entity":"us-california","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":{"freshness":"recent","age_hours_now":156,"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_7cKuMB4g6IvRwLJ35Z3sT","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":"Returns a sequential three-leg drought assessment for a US region: precipitation deficit and soil moisture leading indicators, current USDM official drought class and coverage, and streamflow/impact confirmation.","exampleAgentPrompt":"What's the current drought situation in California — pull the official USDM drought class, how much of the state is affected, and whether soil moisture and streamflow are confirming it?","exampleUseCases":[{"title":"Agricultural water planning for California","prompt":"Check the official drought status for California right now — I need the USDM drought class, area coverage, and whether soil moisture and streamflow are backing it up."},{"title":"Southwest water risk briefing","prompt":"Give me the drought assessment for the US Southwest, including leading indicators like precipitation deficit and snowpack, the current USDM classification, and the streamflow confirmation."},{"title":"Corn Belt crop stress monitoring","prompt":"What does the three-leg drought chain show for the US Corn Belt? I need the leading precipitation and soil moisture signals, the current official drought monitor class, and the streamflow impact reading."}],"resultDescription":"A sequential three-part drought assessment JSON object containing: (1) leading indicators — precipitation deficit, soil moisture, and snowpack status; (2) official USDM drought class (D0–D4) and percentage area coverage; (3) streamflow and realized impact as a confirmation gate. A confidence score reflects how many of the three legs returned valid data. Returns HTTP 422 with no charge if no data is available for the requested region.","failureModes":["422 no_charge returned when no data is available for the requested entity — not billed","Invalid or unrecognized entity ID results in an error; use GET /gauge/catalog?signal_id=<signal_id> to retrieve valid entity list","Partial data may reduce confidence score if only some legs return data","Network or upstream USDM/USGS outage may delay or prevent data retrieval"],"whenToPreferThis":"Choose this endpoint when you need an authoritative, multi-source drought assessment that combines USDM official classifications with leading hydrological indicators (soil moisture, snowpack, precipitation deficit) and confirms with realized streamflow data. Prefer this over a simple weather or precipitation endpoint when you need drought severity classification, area coverage, and impact confirmation in a single structured call. Best for agents monitoring water stress, agricultural risk, or regional environmental conditions in the US.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:53:11.930Z","isFirstParty":false}