{"uid":"cap_fEqKCZDdeUXGudgONheRq","slug":"waterpulse-agricultural-water-intelligence-3c0dc309","name":"WaterPulse Agricultural Water Intelligence","description":"Agricultural water intelligence for grower and ag-trader agents. Returns irrigation demand, water-rights curtailments, and farm water cost, combining USGS groundwater, US Drought Monitor, and USDA data.","url":"https://waterpulse.theaslangroupllc.com/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_8oDfNe7H3TP7G2pOFZHs-","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, water-rights curtailments, and farm water cost for agricultural decision-making by combining USGS groundwater, US Drought Monitor, and USDA data.","exampleAgentPrompt":"What's the current irrigation demand, any active water-rights curtailments, and estimated farm water cost for the San Joaquin Valley in California right now — I need it for my corn operation planning?","exampleUseCases":[{"title":"Commodity futures trading water risk","prompt":"I'm looking at alfalfa futures in Arizona's Pinal County—can you check the current irrigation demand, any water curtailments, and what farmers are likely paying for water there? I need to know if supply pressures are building."},{"title":"Farm investment due diligence check","prompt":"I'm evaluating a cotton farm purchase in Texas. Pull the irrigation demand levels, water-rights status, and current farm water costs for that region so I can model out the water expense risk over the next few years."},{"title":"Precision irrigation scheduling optimization","prompt":"For my rice operation in Arkansas, what's the groundwater availability situation, are there any curtailments I should know about, and what's water pricing looking like right now? I need this to decide if I should irrigate early before costs spike."}],"resultDescription":"Returns structured agricultural water intelligence including irrigation demand levels, any active water-rights curtailments in the queried region, farm water cost estimates, and underlying data signals from USGS groundwater measurements, US Drought Monitor drought categories, and USDA agricultural datasets.","failureModes":["Region not covered by USGS/USDA/Drought Monitor data sources — returns 404 or empty dataset","Invalid or unrecognized geographic identifier — returns 400 bad request","Upstream data source (USGS, USDA, Drought Monitor) temporarily unavailable — returns 503 or stale data warning","Water rights data not available for queried jurisdiction — partial response with null curtailment field","Payment not fulfilled (x402) — returns 402 Payment Required before data is delivered"],"whenToPreferThis":"Use this endpoint when you need combined agricultural water intelligence — specifically the intersection of irrigation demand, water-rights curtailments, and farm water cost — in a single call. Prefer this over generic drought or groundwater endpoints when the use case is agricultural planning, ag-commodity trading, or farm investment analysis where all three dimensions matter together. The multi-source fusion (USGS + Drought Monitor + USDA) makes this superior to single-source alternatives for comprehensive ag-water decision support.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:34:25.116Z","isFirstParty":false}