# opendata402 US River & Stream Conditions

> opendata402 US River & Stream Conditions is a paid API for AI agents from opendata402.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-15).

Retrieves the latest USGS 15-minute water monitoring data (discharge, gage height, or water temperature) for a specific US river or stream site

## Facts

- Endpoint: GET https://opendata402.com/v1/rivers/us?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/opendata402-us-river-stream-conditions-8ab4d050
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ItgH2VVCCQhGORzg-3GnM

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 opendata402-us-river-stream-conditions-8ab4d050
```

Example prompt: What's the current discharge and gage height on the Potomac River near Washington DC? The USGS site number is 01646500.

## When to prefer this

Use this endpoint when you need real-time or near-real-time US river and stream conditions from an authoritative government source (USGS). It is ideal for flood monitoring, recreational planning (kayaking, fishing, rafting), water-dependent operations, and any application needing streamflow or gage height data at a specific USGS site. Prefer this over generic weather APIs when hydrological precision (cubic feet per second, feet of gage height) from an official monitoring network is required.

## Known failure modes

- Invalid or non-existent USGS site number returns an error — site numbers must be 8-15 digits
- Parameter enum value not recognized if misspelled (must be discharge, gage_height, or water_temp)
- USGS upstream API unavailability causes service errors
- Some USGS sites may not measure all three parameter types; requesting an unavailable parameter may return no data
- Provisional data may have gaps during sensor outages or maintenance

## How this service works

Latest US river and stream readings from the USGS water data API (15-minute data): discharge (cubic feet per second), gage height (feet) or water temperature for a USGS monitoring site. Use it for flood watching, paddling and fishing conditions, and water-dependent operations. Site number e.g. 01646500 (Potomac River near Washington DC). Data are provisional.

## Output

Returns the latest provisional 15-minute interval reading for the requested USGS site, including the measurement value (discharge in cfs, gage height in feet, or water temperature), the timestamp of the observation, and the parameter type. Data is marked as provisional and subject to revision.

## 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",
       "pattern": "^\\d{8,15}$",
       "description": "USGS site number."
      },
      "parameter": {
       "enum": [
        "discharge",
        "gage_height",
        "water_temp"
       ],
       "type": "string",
       "description": "discharge (default), gage_height or water_temp."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/opendata402-us-river-stream-conditions-8ab4d050/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from opendata402.com](https://www.zero.xyz/host/opendata402.com/llms.txt)