{"uid":"cap__rn8BdEFfbbZ4pwSDZkge","slug":"waterpulse-groundwater-levels-api-507e8458","name":"WaterPulse Groundwater Levels API","description":"Real-time water intelligence API. Groundwater levels, streamflow, drought status, water quality, aquifer analysis, flood risk, and global water stress — pay-per-query via x402.","url":"https://waterpulse-henna.vercel.app/api/water/groundwater","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-09-15T12:43:07.333Z","isFirstParty":false}