# USGS Stream Gauge Streamflow & Gauge Height Lookup

> USGS Stream Gauge Streamflow & Gauge Height Lookup is a paid API for AI agents from x402-seller.onrender.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Returns real-time streamflow (cfs) and gauge height (ft) for a given USGS stream gauge site number.

## Facts

- Endpoint: GET https://x402-seller.onrender.com/water/streamflow
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/usgs-stream-gauge-streamflow-gauge-height-lookup-b02f9c7b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UHVV-bSW4OXPYwr0TSKtC

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 usgs-stream-gauge-streamflow-gauge-height-lookup-b02f9c7b
```

Example prompt: What are the current streamflow and gauge height readings at USGS site 09380000, the Colorado River at Lees Ferry?

## When to prefer this

Use this endpoint when you need real-time river conditions (streamflow and gauge height) from an official U.S. government source for a specific USGS monitoring site. Prefer this over general weather APIs when hydrological precision matters — e.g. flood monitoring, recreational river safety, water resource planning, or environmental compliance. Best when you already have a USGS site number.

## Known failure modes

- Invalid or non-existent USGS site number returns an error or null values
- Site exists but has no recent data — streamflowCfs and gaugeHeightFt may be null
- USGS upstream API unavailable causes a service error
- Missing required 'site' query parameter returns a validation error
- Site exists but does not measure streamflow or gauge height — fields will be null

## How this service works

Real-time river and stream conditions at a USGS stream gauge — current streamflow/discharge (cubic feet per second) and gauge height/water level/stage (feet), i.e. how much water is flowing and how high it is right now. Data is provisional and subject to revision. Requires a USGS site number (e.g. 09380000 = Colorado River at Lees Ferry, AZ).

## Output

Returns a JSON object with the USGS site number, site name, real-time streamflow in cubic feet per second, gauge height in feet, geographic coordinates (lat/lng), timestamp of the reading, a provisional data flag, data source label, and attribution string.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "site"
     ],
     "properties": {
      "site": {
       "type": "string",
       "description": "USGS site number (e.g. 09380000)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "lat": {
       "type": [
        "number",
        "null"
       ]
      },
      "lng": {
       "type": [
        "number",
        "null"
       ]
      },
      "site": {
       "type": "string"
      },
      "time": {
       "type": [
        "string",
        "null"
       ]
      },
      "source": {
       "type": "string"
      },
      "siteName": {
       "type": [
        "string",
        "null"
       ]
      },
      "attribution": {
       "type": "string"
      },
      "provisional": {
       "type": "boolean"
      },
      "gaugeHeightFt": {
       "type": [
        "number",
        "null"
       ]
      },
      "streamflowCfs": {
       "type": [
        "number",
        "null"
       ]
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/usgs-stream-gauge-streamflow-gauge-height-lookup-b02f9c7b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-seller.onrender.com](https://www.zero.xyz/host/x402-seller.onrender.com/llms.txt)