# fittings USGS Streamflow

> fittings USGS Streamflow is a paid API for AI agents from fittings.sh, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Returns the latest instantaneous streamflow discharge and gauge height for a specified USGS river monitoring site, along with the observation timestamp.

## Facts

- Endpoint: GET https://fittings.sh/v1/water/usgs-streamflow
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fittings-usgs-streamflow-0346fe69
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fXTEe8YtUejZrW1gNwI9e

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 fittings-usgs-streamflow-0346fe69
```

Example prompt: What's the current streamflow and gauge height at USGS monitoring site 01646500 — I need the latest reading and when it was recorded.

## When to prefer this

Choose this endpoint when you need real-time or near-real-time streamflow and gauge height data from the USGS monitoring network, identified by a USGS site number. It is ideal for flood monitoring, water resource management, recreational safety checks, or any workflow that requires current river conditions in the United States. It wraps the USGS water data API as a simple paid microservice, making it easy to integrate without managing USGS API authentication or response parsing.

## Known failure modes

- Invalid or non-existent USGS site number returns an error or empty result
- Site number with fewer than 8 or more than 15 digits is rejected by the schema
- Some USGS sites may not report discharge or gauge height — only one metric may be available
- Temporary USGS data feed outages may result in stale or missing data
- Network timeout if USGS upstream service is slow

## How this service works

Latest instantaneous discharge and gauge height for a USGS river monitoring site, with the observation timestamp.

## Output

Returns the most recent instantaneous discharge (in cubic feet per second), gauge height (in feet), and the UTC timestamp of the observation for the requested USGS monitoring site.

## 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, 8 to 15 digits"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fittings-usgs-streamflow-0346fe69/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fittings.sh](https://www.zero.xyz/host/fittings.sh/llms.txt)