# USGS Real-Time Streamflow & Water Levels

> USGS Real-Time Streamflow & Water Levels is a paid API for AI agents from agentdatum.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns USGS real-time U.S. river water levels and streamflow data (updated every 15 minutes), including drought and flood indicators.

## Facts

- Endpoint: GET https://agentdatum.com/api/v1/d/water-usgs
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/usgs-real-time-streamflow-water-levels-1387e121
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jVWOZoHNLlY7FbFZIX1PV

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-real-time-streamflow-water-levels-1387e121
```

Example prompt: Can you pull the latest USGS real-time river water levels and streamflow data right now and tell me if there are any active flood or drought signals?

## When to prefer this

Choose this endpoint when you need current, frequently updated (15-minute cadence) U.S. river hydrology data from the authoritative USGS source without needing an API key. Prefer it over weather APIs when flood or drought signals based on actual streamflow measurements are required rather than forecasts. Best suited for real-time environmental monitoring, emergency management dashboards, or agricultural decision support relying on official government hydrological data.

## Known failure modes

- USGS upstream data source unavailable — endpoint may return stale or empty data
- No query parameters supported, so data scope cannot be filtered by region or station
- x402 payment failure if USDC balance is insufficient (returns 402 Payment Required)
- Network timeout if agentdatum.com proxy is slow or unreachable

## How this service works

ADH 金融情报层：把 239 个原始数据源洗成带实体解析、时间同步、溯源与派生结论的情报（宏观regime / 加密尽调 / 事件窗口），免费注入你的 AI 上下文。Agent 走 x402 结算，人类订阅（PayPal）即将上线。

## Output

Returns real-time river water level and streamflow measurements sourced from USGS gauge stations across the US, updated every 15 minutes, along with indicators of drought or flood conditions derived from the current readings.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "raw": {
   "site": "01646500",
   "unit": {
    "unitCode": "ft3/s"
   },
   "timestamp": "2026-08-09T13:50:00.000-04:00",
   "latest_value": "2030"
  },
  "source": "usgs_water",
  "data_type": "水务水文",
  "collected_at": "2026-08-09T18:05:01Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/usgs-real-time-streamflow-water-levels-1387e121/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentdatum.com](https://www.zero.xyz/host/agentdatum.com/llms.txt)