# WaterPulse Groundwater Levels API

> WaterPulse Groundwater Levels API is a paid API for AI agents from waterpulse-henna.vercel.app, paid per call via x402, $0.08/call, status unknown (last checked 2026-09-15).

Returns real-time depth-to-water measurements, trend analysis, and drought risk context from USGS monitoring wells for any US state.

## Facts

- Endpoint: GET https://waterpulse-henna.vercel.app/api/water/groundwater
- Price: $0.08/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/waterpulse-groundwater-levels-api-507e8458
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__rn8BdEFfbbZ4pwSDZkge

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability waterpulse-groundwater-levels-api-507e8458
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/waterpulse-groundwater-levels-api-507e8458/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from waterpulse-henna.vercel.app](https://www.zero.xyz/host/waterpulse-henna.vercel.app/llms.txt)