# WaterPulse Streamflow API

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

Returns real-time streamflow conditions, flood-stage context, and low-flow drought signals from USGS gauge stations for a given location or gauge ID.

## Facts

- Endpoint: GET https://waterpulse-henna.vercel.app/api/water/streamflow
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/waterpulse-streamflow-api-1feab3b2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rPgyvsNQ2JzBVZ1fy9Qkx

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-streamflow-api-1feab3b2
```

Example prompt: What are the current streamflow conditions at USGS gauge station 01646500 on the Potomac River — is it in flood stage, normal range, or showing low-flow drought signals?

## When to prefer this

Choose this endpoint when you need real-time, station-level streamflow data with explicit flood-stage context and drought/low-flow signals from USGS gauges. Prefer this over general weather APIs that lack hydrological specificity, and over this provider's flood-risk endpoint when you need raw streamflow metrics rather than composite flood risk scores.

## Known failure modes

- Invalid or unknown USGS gauge station ID returns a 404 or error response
- USGS data feed temporarily unavailable causes stale or missing data
- Location input that cannot be resolved to a gauge station returns no results
- Gauge station offline or under maintenance returns no current readings
- Payment not processed (x402) results in 402 response before data is returned

## How this service works

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.

## Output

Returns current streamflow measurements (likely in CFS or CMS), flood-stage classification indicating whether the river is below, at, or above flood threshold, and low-flow drought signals indicating hydrological drought conditions, sourced from the relevant USGS gauge station.

## 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)"
      },
      "site": {
       "type": "string",
       "description": "USGS site number (optional) — e.g. 09380000 (Colorado River at Lees Ferry)"
      },
      "limit": {
       "type": "string",
       "description": "5 | 10 | 20 (default: 10)"
      },
      "state": {
       "type": "string",
       "description": "Two-letter US state code — e.g. CO | OR | TN | NY"
      }
     }
    }
   },
   "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": {
  "signal": "Widespread below-normal flows across Colorado indicate ongoing drought stress. No flood risk at monitored sites.",
  "data_source": "USGS Instantaneous Values Water Services",
  "flow_summary": {
   "sites_in_flood": 0,
   "lowest_flow_site": "Arkansas River nr Pueblo — 34% of median",
   "sites_above_normal": 1,
   "sites_below_normal": 8
  },
  "query_summary": {
   "state": "CO",
   "parameter": "discharge_cfs",
   "sites_analyzed": 10
  },
  "stream_readings": [
   {
    "date_time": "2026-06-07T14:00:00",
    "site_code": "09380000",
    "site_name": "Colorado River at Lees Ferry, AZ",
    "discharge_cfs": "8420",
    "flow_condition": "Below normal",
    "percent_of_median": 61
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/waterpulse-streamflow-api-1feab3b2/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)