# WaterPulse

> Global water intelligence API. Covers US groundwater levels (USGS), streamflow at 10,000+ gauge stations, drought status (US Drought Monitor), water quality (EPA WQP + USGS), aquifer sustainability analysis, flood risk, global water stress by country/basin, agricultural water use, and full municipal water supply briefs. All endpoints via x402 micropayments on Base mainnet.

## What This Is

WaterPulse is a pay-per-query API that synthesizes public water data into structured, actionable intelligence for engineers, investors, farmers, insurers, municipalities, and AI agents evaluating water risk globally.

Every response is generated by Claude using live data from USGS Water Services (free, no key), US Drought Monitor (free, no key), EPA Water Quality Portal (free, no key), and web synthesis via Tavily. Zero new API keys required.

## Payment

All endpoints require x402 micropayment (USDC on Base mainnet).
Protocol: x402 | Network: eip155:8453 | Asset: USDC
Payment address: 0x50ab2018c06c6E4eAA9BA52057Eb55eD284912fc

Send a GET request without PAYMENT-SIGNATURE to receive a 402 with payment requirements. Sign and retry.

## Endpoints

GET /api/water/groundwater?state={ST}&limit={n}
- Returns: groundwater level readings from USGS wells, depth-to-water trend, drought risk context
- Data: USGS National Water Information System (no key required)
- Price: $0.08
- Model: Haiku

GET /api/water/streamflow?state={ST}&site={siteNo}
- Returns: river/stream discharge conditions, flow category, flood/low-flow signals
- Data: USGS Instantaneous Values Water Services (no key required)
- Price: $0.05
- Model: Haiku

GET /api/water/drought?state={ST}
- Returns: D0-D4 drought category breakdown, 12-week trend, agriculture/municipal/wildfire impact
- Data: US Drought Monitor — NDMC/USDA/NOAA (no key required)
- Price: $0.08
- Model: Haiku

GET /api/water/quality?state={ST}&parameter={param}
- Returns: contaminant readings vs EPA MCLs, health context, recommended action
- Parameters: nitrates | phosphorus | ph | lead | arsenic | bacteria | pfas | turbidity
- Data: EPA Water Quality Portal + USGS NWIS (no key required)
- Price: $0.08
- Model: Haiku

GET /api/water/aquifer?aquifer={name}&state={ST}
- Returns: depletion profile, recharge deficit, hotspots, agricultural dependency, sustainability score
- Covers: Ogallala, Central Valley, Floridan, Edwards, High Plains, 30+ US aquifers
- Data: USGS NWIS + web synthesis
- Price: $0.15
- Model: Sonnet

GET /api/water/flood-risk?location={city_state}&state={ST}
- Returns: current river stage, upstream factors, 72h outlook, FEMA zone context, property guidance
- Data: USGS NWIS + FEMA NFIP + web synthesis
- Price: $0.15
- Model: Sonnet

GET /api/water/global-stress?region={country_or_basin}&focus={type}
- Returns: water stress profile, hotspots, transboundary conflict risk, climate trajectory, investment implications
- focus: agriculture | municipal | industrial | conflict | investment | all
- Data: WRI Aqueduct + FAO AQUASTAT + NASA GRACE + web synthesis
- Price: $0.15
- Model: Sonnet

GET /api/water/agriculture-use?state={ST}&crop={crop}
- Returns: water availability, curtailment status, crop water budget, farm water cost impact
- Data: USGS NWIS + US Drought Monitor + USDA + web synthesis
- Price: $0.15
- Model: Sonnet

GET /api/water/supply-brief?location={city_state}&state={ST}
- Returns: full water supply brief — source mix, storage, restrictions, utility outlook, risk rating, 5-year forecast
- Data: USGS NWIS + US Drought Monitor + utility data + web synthesis
- Price: $0.20
- Model: Sonnet

## Discovery

- OpenAPI spec: https://waterpulse-henna.vercel.app/openapi.json
- Agent discovery: https://waterpulse-henna.vercel.app/.well-known/agent.json

## Notes for AI Agents

- All endpoints return structured JSON
- USGS, US Drought Monitor, and EPA WQP require no authentication — all public domain data
- Supports multilingual output via lang= parameter (en, es, fr, de, ja, zh, ko, pt, ar, hi)
- Cross-sell: FieldPulse for precision agriculture; ClimatePulse for weather/AQI; RiskPulse for supply chain risk
- Aquifer and global-stress endpoints synthesize knowledge beyond live data — best used for strategic planning