{"uid":"cap__rn8BdEFfbbZ4pwSDZkge","slug":"waterpulse-groundwater-levels-api-507e8458","name":"WaterPulse Groundwater Levels API","description":"Real-time groundwater levels for water and hydrology agents. Returns depth-to-water, trend analysis, and drought risk context from USGS monitoring wells for any US state.","url":"https://waterpulse-henna.vercel.app/api/water/groundwater?utm_source=zero.xyz","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":{"lang":{"type":"string","description":"en | es | fr | de | ja | zh | ko | pt | ar (default: en)"},"limit":{"type":"string","description":"5 | 10 | 20 (default: 10)"},"state":{"type":"string","description":"Two-letter US state code — e.g. CA | TX | AZ | FL | KS"}}}},"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":{"data_source":"USGS National Water Information System","query_summary":{"state":"CA","data_period":"last 30 days","sites_analyzed":10},"state_summary":{"median_depth_ft":138,"drought_connection":"Readings 32% below 10-year median; consistent with D3 Extreme Drought across Central Valley","sites_above_normal":2,"sites_below_normal":7},"risk_assessment":"High depletion pressure — Central Valley aquifer declining 8-12 ft/year. Agricultural curtailments likely Q3 2026.","groundwater_readings":[{"date":"2026-06-05","trend":"declining","site_code":"11339100","site_name":"San Joaquin Valley Well 14N/14E-26F1","depth_to_water_ft":"142.3","percent_of_normal":68}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.08","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.08/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.08","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.08","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_fB2ljN4NpfvvfQck0b4aY","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.08","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns real-time depth-to-water measurements, trend analysis, and drought risk context from USGS monitoring wells for any US state.","exampleAgentPrompt":"What are the current groundwater levels and depth-to-water trends in Colorado right now, and is there any drought risk flagged for that state?","exampleUseCases":null,"resultDescription":"Returns real-time depth-to-water measurements from USGS monitoring wells for the requested US state, along with trend analysis indicating whether groundwater levels are rising, stable, or declining, and contextual drought risk assessment tied to current aquifer conditions.","failureModes":["Invalid or unrecognized US state returns a 400 error","USGS data unavailable or delayed may result in stale or missing readings","States with sparse monitoring well coverage may return limited data points","Network timeout or upstream USGS API outage returns 503","Payment not processed correctly returns 402"],"whenToPreferThis":"Choose this endpoint when you need current, well-level groundwater depth data with trend context and drought risk framing for a specific US state. Prefer this over general drought endpoints when the focus is specifically on subsurface water table conditions rather than surface-level drought categories, and over aquifer endpoints when you need real-time monitoring data rather than long-term depletion rates.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T13:07:09.504Z","isFirstParty":false,"canonicalSlug":"waterpulse-groundwater-levels-api-507e8458"}