{"uid":"cap_2SAiK_qlwRQCrXREC_Pbp","slug":"waterpulse-agricultural-water-intelligence-cd839561","name":"WaterPulse Agricultural Water Intelligence","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/agriculture-use","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":{"crop":{"type":"string","description":"Crop type (optional) — e.g. \"alfalfa\" | \"cotton\" | \"corn\" | \"almonds\" | \"rice\""},"lang":{"type":"string","description":"en | es | fr | de | ja | zh | ko | pt | ar (default: en)"},"state":{"type":"string","description":"Two-letter US state code — e.g. CA | ID | NE | WA | CO"}}}},"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":{"risk_flags":["SGMA sustainable yield limits tighten 2027 — expect further pumping restrictions","Almond tree permanence makes water access risk existential vs annual crops"],"cost_impact":{"year_over_year_change":"+22% vs 2024 — driven by SGMA pumping fees and scarcity premium","water_cost_per_acre_ft_surface":"$85–$220 (district dependent)","water_cost_per_acre_ft_groundwater":"$250–$500 (pumping + SGMA compliance)","estimated_water_cost_per_acre_almonds":"$875–$1750"},"query_summary":{"crop":"almonds","state":"CA","season":"2026","irrigation_season":"April–October"},"crop_water_budget":{"crop":"Almonds","deficit_estimate_pct":35,"total_demand_acre_feet":4900000,"total_ca_almond_acreage":1400000,"estimated_acre_feet_per_acre":3.5},"strategic_guidance":"Growers with pre-1914 water rights or senior district contracts have material competitive advantage. Deficit irrigation scheduling (50-70% ET replacement) reduces nut size but preserves tree health under curtailment.","water_availability":{"drought_status":"71% of state in D2-D4 drought","groundwater_trend":"Declining — San Joaquin Valley wells 28% below 10-year median","curtailment_detail":"Pre-1914 rights protected; junior rights (post-1914) receiving 0-15% of allocation in Sacramento/San Joaquin","curtailments_active":true,"surface_water_allocation":"State Water Project deliveries at 15% of contract — below-average snowpack"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.15","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.15/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_axVwFzy42l-J4J27FeGiv","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.15","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns irrigation demand forecasts, water-rights curtailments, and farm water cost estimates for a given agricultural area by combining USGS groundwater, US Drought Monitor, and USDA data.","exampleAgentPrompt":"What's the current irrigation demand, any water-rights curtailments, and estimated farm water cost for agricultural operations in Fresno County, California right now?","exampleUseCases":[{"title":"Seasonal water budget planning for growers","prompt":"I'm planning next season's budget for my alfalfa operation in the Imperial Valley. Can you check what the irrigation demand forecast looks like, whether there are any active water-rights curtailments I need to account for, and what I should expect to pay for water this year?"},{"title":"Real-time curtailment alerts for farm operations","prompt":"We farm across multiple counties in Colorado and need to know immediately if any water-rights curtailments are affecting our fields. Pull the latest curtailment notices and irrigation demand levels for our area so we can adjust our planting strategy."},{"title":"Agricultural water cost comparison across regions","prompt":"We're deciding whether to expand operations in the Texas Panhandle or stick with our current Nebraska farms. Can you get me the current farm water costs, irrigation demand, and any curtailment restrictions for both regions so we can compare?"}],"resultDescription":"Returns structured data including current irrigation demand levels, active water-rights curtailment notices, and estimated farm water costs for the queried region, sourced from USGS groundwater readings, US Drought Monitor drought categories, and USDA agricultural water data.","failureModes":["Region not covered by USGS or USDA data sources — returns 404 or empty dataset","Invalid or unrecognized geographic parameter — returns 400 bad request","Upstream data source temporarily unavailable (USGS or Drought Monitor outage) — returns 503","Rate limit or payment failure via x402 — returns 402 payment required","No current curtailment data available for the requested region — returns partial results"],"whenToPreferThis":"Use this endpoint when an agent needs combined agricultural water intelligence — specifically the intersection of irrigation demand, water-rights curtailment status, and farm water cost — for US agricultural regions. Prefer this over generic drought or streamflow endpoints when the user is a grower, ag-trader, or farm operator who needs actionable water economics data, not just raw hydrological readings.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:34:58.697Z","isFirstParty":false}