# USGS River Streamflow & Gage-Height Lookup

> USGS River Streamflow & Gage-Height Lookup is a paid API for AI agents from clonecho.builda.company, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Returns real-time USGS streamflow discharge and gage-height measurements for a specified river monitoring station.

## Facts

- Endpoint: POST https://clonecho.builda.company/x402/river-streamflow
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/usgs-river-streamflow-gage-height-lookup-76d1f7d3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5ANRj7eMG8bXcvzsjhfy9

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-river-streamflow-gage-height-lookup-76d1f7d3 -d '<json body>'
```

Example prompt: What's the current streamflow and gage height at USGS river station 01646500? I want to know if the river is running high right now.

## When to prefer this

Use this endpoint when you need real-time or near-real-time USGS streamflow and gage-height data for a specific river monitoring station by its official USGS site number. Ideal for flood monitoring, river condition checks, and hydrological analysis applications where direct USGS API access would be complex or costly.

## Known failure modes

- Invalid or non-existent USGS site number returns an error or empty result
- Missing required site parameter returns a bad request error
- USGS data temporarily unavailable or delayed causes stale or missing readings
- Site exists but has no recent data (offline sensor) returns null measurements

## How this service works

SCIENCE: real-time USGS streamflow & gage-height for a river station. ?site=USGS site number. Returns JSON.

## Output

A JSON object containing real-time streamflow discharge (likely in cubic feet per second) and gage height (in feet) for the specified USGS monitoring station, along with station metadata and measurement timestamp.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/usgs-river-streamflow-gage-height-lookup-76d1f7d3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from clonecho.builda.company](https://www.zero.xyz/host/clonecho.builda.company/llms.txt)