# AgentToll Water Levels — USGS Water Level Data for AI Agents

> AgentToll Water Levels — USGS Water Level Data for AI Agents is a paid API for AI agents from agenttoll.dev, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-14).

Retrieves real-time or recent water level (stream gauge) data for a given US state and measurement parameter via USGS federal data sources.

## Facts

- Endpoint: POST https://agenttoll.dev/paid/env/water-levels
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agenttoll-water-levels-usgs-water-level-data-for-ai-agents-608028ce
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mXo4UCk6LAD-OVgpnsuSi

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 agenttoll-water-levels-usgs-water-level-data-for-ai-agents-608028ce -d '<json body>'
```

Example prompt: Can you pull the current water level readings from USGS for rivers in California using parameter code 00065?

## When to prefer this

Choose this endpoint when you need programmatic, pay-per-call access to USGS water level or streamflow data filtered by US state and parameter type, especially in agentic workflows that use x402/USDC micropayments. Prefer this over direct USGS API calls when you want a normalized, agent-friendly JSON response without managing USGS API keys or raw data parsing.

## Known failure modes

- Missing or invalid state code returns empty data or error
- Unsupported or incorrect USGS parameter code yields no results
- USGS upstream API unavailability causes failure or stale cached response
- No gauges active in the requested state returns empty data array
- Payment failure (insufficient USDC) blocks the request entirely

## How this service works

108+ receipt-backed x402 work products for AI agents. Clear prices, spend caps, buyer metadata, and structured results over Base USDC.

## Output

Returns an array or object of water level data records from USGS for the specified state and parameter code, along with metadata including the record count, data source identifier, and the datetime the response was generated. Also indicates whether the response was served from cache.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "state": {
   "type": "string"
  },
  "parameter_code": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "oneOf": [
    {
     "type": "array"
    },
    {
     "type": "object"
    }
   ]
  },
  "meta": {
   "type": "object",
   "properties": {
    "count": {
     "type": "integer"
    },
    "source": {
     "type": "string"
    },
    "generated_at": {
     "type": "string",
     "format": "date-time"
    }
   }
  },
  "cached": {
   "type": "boolean"
  },
  "success": {
   "type": "boolean"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agenttoll-water-levels-usgs-water-level-data-for-ai-agents-608028ce/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agenttoll.dev](https://www.zero.xyz/host/agenttoll.dev/llms.txt)