{"uid":"cap_4kYxsHMHHLGXkb6c3cwX8","slug":"waterpulse-supply-snapshot-fca464e8","name":"WaterPulse Supply Snapshot","description":"Deterministic water-supply numbers snapshot for a US state — latest USGS groundwater well readings (depth-to-water) and current US Drought Monitor D0-D4 breakdown. No LLM, no web search. The $0.50 /api/water/supply-brief adds reservoir storage, utility outlook, restrictions, rate trajectory, and a synthesized 5-year risk rating.","url":"https://waterpulse.theaslangroupllc.com/api/water/supply-snapshot","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"state":{"type":"string","description":"Two-letter US state code for USGS/drought data — e.g. AZ | NV | GA | CO"},"location":{"type":"string","description":"City or metro area — e.g. \"Phoenix AZ\" | \"Las Vegas NV\" | \"Atlanta GA\" | \"Denver CO\" (label only; data is state-level)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"errors":{"type":"object","description":"Documented error responses, keyed by HTTP status code","additionalProperties":{"type":"object","required":["description"],"properties":{"example":{"type":"object"},"description":{"type":"string"}}}},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"upsell":{"adds":"Reservoir storage, utility supply outlook, infrastructure investment, rate trajectory, drought restrictions, and a synthesized 5-year risk rating for this location.","price_usd":0.5,"full_product":"/api/water/supply-brief"},"deterministic":true,"query_summary":{"state":"AZ","location":"Phoenix AZ","report_date":"2026-07-25"},"drought_snapshot":{"as_of":"2026-07-22","none_pct":12,"d2_severe_pct":25,"d3_extreme_pct":12,"in_drought_pct":88,"d1_moderate_pct":28,"d4_exceptional_pct":5,"d0_abnormally_dry_pct":18},"groundwater_snapshot":{"readings":[{"date_time":"2026-07-25T00:00:00.000-07:00","site_code":"332420112000001","site_name":"WELL NEAR PHOENIX, AZ","depth_to_water_ft":45.2}],"wells_reporting":8,"depth_to_water_ft":{"avg":88.1,"max":210.6,"min":12.4}}}},"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_xnRg6kCDFLduDL5lc9FRQ","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 combined drought and groundwater depth snapshot for a given US location, pulling from USGS and US Drought Monitor sources.","exampleAgentPrompt":"Pull up the current water supply snapshot for Phoenix, AZ — I want to see the drought severity breakdown and how deep the groundwater is at nearby wells as of today.","exampleUseCases":[{"title":"Drought risk check for real estate","prompt":"Before I close on a property in Phoenix, AZ, can you pull the current drought snapshot so I can see what percentage of the area is in extreme or exceptional drought and how deep the groundwater is?"},{"title":"Environmental compliance monitoring","prompt":"I need to track water conditions in Tucson, AZ on a weekly basis — can you grab the latest drought severity percentages and groundwater depth readings for that area?"},{"title":"Agricultural water planning","prompt":"We're farming near Yuma, AZ and need to know the current drought status and average depth to water at local wells — can you get me the supply snapshot for that location?"}],"resultDescription":"Returns a JSON object with: a drought_snapshot showing percentages of the queried area in each drought category (D0–D4, none, in_drought), a groundwater_snapshot listing individual well readings (site name, code, depth to water in feet, datetime) plus aggregate stats (avg/min/max depth, number of wells reporting), and a query_summary confirming the state, location, and report date. Also includes an upsell pointer to a richer /api/water/supply-brief endpoint.","failureModes":["Location not found or ambiguous — returns error if the state/city cannot be resolved to a monitoring region","No wells reporting — groundwater_snapshot may return empty readings array if no USGS wells are active in the area","Drought Monitor data lag — drought_snapshot as_of date may be several days behind current date due to weekly update cadence","Invalid or missing required parameters — returns 400-style error if state or location is not provided","Payment failure — x402 payment of $0.25 USDC required; unpaid requests return 402"],"whenToPreferThis":"Choose this endpoint when you need a fast, combined view of drought severity and groundwater depth for a specific US location without needing full infrastructure, reservoir, or rate trajectory data. It is the lightweight entry point (at $0.25) compared to the richer /api/water/supply-brief ($0.50). Prefer this for quick environmental checks, risk screening, or monitoring workflows where summary-level drought and well data is sufficient.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:39:23.531Z","isFirstParty":false}