# srch.best Water Data API

> srch.best Water Data API is a paid API for AI agents from x402.srch.best, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns structured USGS water monitoring data (streamflow, gage height, temperature, etc.) for specified station IDs via pay-per-request x402 protocol

## Facts

- Endpoint: POST https://x402.srch.best/water
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/srch-best-water-data-api-b9c1bcc0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hU3cbnkYcny5sofqCFR_k

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 srch-best-water-data-api-b9c1bcc0 -d '<json body>'
```

Example prompt: Pull the latest streamflow and gage height readings for USGS stations 01646500 and 01638500 — I need up to 50 records per station.

## When to prefer this

Choose this endpoint when you need structured, agent-ready USGS hydrological data without building a USGS API integration yourself. Ideal for agents needing pay-per-use water monitoring data (streamflow, gage height, water quality) at specific USGS stations with minimal setup. Prefer over raw USGS NWIS API when you want normalized output, x402 micropayment compatibility, and a consistent schema. Use when monitoring river conditions, assessing flood risk, or gathering water quality metrics for environmental analysis.

## Known failure modes

- Invalid station ID format (must be 5–15 digit numeric string) returns validation error
- Station ID not found in USGS database returns empty or error response
- Payment failure via x402 protocol returns 402 Payment Required
- Requesting more than 10 station IDs returns schema validation error
- Requesting more than 6 parameters returns schema validation error
- Station exists but has no data for requested parameters returns empty result set
- Network timeout for stations with large historical datasets

## How this service works

Structured water data for agents, paid per request with x402 v2

## Output

A structured JSON response containing time-series water monitoring measurements for the requested USGS station IDs, including up to 6 parameter types (streamflow, gage height, water temperature, dissolved oxygen, specific conductance, pH) with up to 100 records per call, returned in a normalized format suitable for agent consumption.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "default": 50,
   "maximum": 100,
   "minimum": 1
  },
  "parameters": {
   "type": "array",
   "items": {
    "enum": [
     "streamflow",
     "gage_height",
     "water_temperature",
     "dissolved_oxygen",
     "specific_conductance",
     "ph"
    ],
    "type": "string"
   },
   "default": [
    "streamflow",
    "gage_height"
   ],
   "maxItems": 6,
   "minItems": 1
  },
  "stationIds": {
   "type": "array",
   "items": {
    "type": "string",
    "pattern": "^\\d{5,15}$"
   },
   "maxItems": 10,
   "minItems": 1
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/srch-best-water-data-api-b9c1bcc0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.srch.best](https://www.zero.xyz/host/x402.srch.best/llms.txt)