# WaterPulse Groundwater Levels API

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

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.theaslangroupllc.com/api/water/groundwater
- Price: $0.08/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/waterpulse-groundwater-levels-api-2e6822fe
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WmSDDqij3cuQBwICoJB5A

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-2e6822fe
```

Example prompt: What are the current groundwater levels in Arizona — specifically the depth-to-water, whether the trend is rising or falling, and any drought risk context from USGS monitoring wells?

## When to prefer this

Use this endpoint when you need real-time, well-level groundwater depth and trend data for a specific US state sourced from USGS monitoring infrastructure. Prefer this over drought status endpoints (which report categorical drought classifications) when you need raw hydrological depth-to-water measurements and trend trajectories. Choose this over aquifer analysis endpoints when you want current conditions rather than long-term depletion or recharge modeling.

## Known failure modes

- State not recognized or invalid — returns 400 or empty result
- No USGS monitoring wells available for the queried region — returns partial or empty data
- USGS data feed temporarily unavailable — may return stale or error response
- Network timeout on real-time data fetch — may return 504 or timeout error

## 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 depth-to-water measurements from USGS monitoring wells for the queried US state, along with trend analysis (rising/falling/stable), and drought risk context derived from current groundwater 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-2e6822fe/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from waterpulse.theaslangroupllc.com](https://www.zero.xyz/host/waterpulse.theaslangroupllc.com/llms.txt)