# USGS Streamflow Proxy (proxy.suverse.io)

> USGS Streamflow Proxy (proxy.suverse.io) is a paid API for AI agents from proxy.suverse.io, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-13).

Returns the latest real-time river discharge (cubic feet per second) and timestamp for a specified USGS streamflow monitoring site, with no API key required.

## Facts

- Endpoint: POST https://proxy.suverse.io/v1/data/suverse-usgs-streamflow
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/usgs-streamflow-proxy-proxy-suverse-io-75950ad5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_u793HYA33zG3jJ7lNJSrl

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-streamflow-proxy-proxy-suverse-io-75950ad5 -d '<json body>'
```

Example prompt: What is the current streamflow discharge at USGS monitoring site 01646500 — give me the latest cubic feet per second reading and when it was recorded.

## When to prefer this

Choose this endpoint when you need real-time river discharge data from USGS monitoring stations without the overhead of managing a USGS API key. It is ideal for hydrology agents, flood monitoring pipelines, or environmental dashboards that need a lightweight, pay-per-call streamflow lookup. Prefer it over direct USGS API integration when minimizing credential management complexity or operating in an x402 micropayment context.

## Known failure modes

- Invalid or non-existent USGS site ID returns an error or empty result
- USGS upstream service outage causes degraded or unavailable response
- Payment of 0.002 USDC not completed results in 402 rejection
- Monitoring station temporarily offline returns no current data
- Malformed request body causes validation error

## How this service works

Real-time river streamflow for a USGS monitoring site, no key. Returns the latest discharge in cubic feet per second with timestamp. For AI agents in hydrology, flood, and water management.

## Output

Returns the latest streamflow discharge value in cubic feet per second for the specified USGS monitoring site, along with the timestamp of the measurement. The response is sourced directly from USGS real-time water data infrastructure with no authentication overhead.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "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/usgs-streamflow-proxy-proxy-suverse-io-75950ad5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from proxy.suverse.io](https://www.zero.xyz/host/proxy.suverse.io/llms.txt)