{"uid":"cap_mXo4UCk6LAD-OVgpnsuSi","slug":"agenttoll-water-levels-usgs-water-level-data-for-ai-agents-608028ce","name":"AgentToll Water Levels — USGS Water Level Data for AI Agents","description":"108+ receipt-backed x402 work products for AI agents. Clear prices, spend caps, buyer metadata, and structured results over Base USDC.","url":"https://agenttoll.dev/paid/env/water-levels","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"state":{"type":"string"},"parameter_code":{"type":"string"}}},"responseSchema":{"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"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_v1UW5xGFyhdeWRBi61FvG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves real-time or recent water level (stream gauge) data for a given US state and measurement parameter via USGS federal data sources.","exampleAgentPrompt":"Can you pull the current water level readings from USGS for rivers in California using parameter code 00065?","exampleUseCases":[{"title":"Flood risk monitoring for emergency response","prompt":"Get me the latest USGS water level data for all monitored gauges in Louisiana — use parameter code 00065 for gauge height — I need to assess current flood risk."},{"title":"Environmental research data collection","prompt":"I'm studying hydrological trends in Texas. Can you fetch the current USGS water level readings for that state using the streamflow parameter code 00060?"},{"title":"Real-time river condition check","prompt":"What are the current water levels on rivers in Oregon right now? Use the standard gauge height parameter from USGS federal data."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:54:05.573Z","isFirstParty":false}