{"uid":"cap_JYv0qOHhnzJKZHae1OOyb","slug":"usgs-stream-gage-flow-via-suverse-proxy-8842470c","name":"USGS Stream Gage Flow via Suverse Proxy","description":"Real-time river discharge from a USGS stream gage. Pass an NWIS site number and a period (ISO 8601 duration) to get instantaneous flow (parameter 00060) values. Keyless USGS Water Services data for hydrology and flood monitoring.","url":"https://proxy.suverse.io/v1/data/suverse-earth-streamgage-flow?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.06","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.06/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.06","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.06","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_fLFKqK_j3q58NM4PMZhzr","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.06","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches real-time instantaneous river discharge (flow) data from a USGS NWIS stream gage for a given site number and time period.","exampleAgentPrompt":"Pull the real-time river discharge data for USGS stream gage site 01646500 over the past 7 days (P7D) so I can check recent flow conditions on the Potomac.","exampleUseCases":[{"title":"Flood early-warning monitoring","prompt":"Get me the instantaneous streamflow readings for USGS gage site 11446500 (Sacramento River) for the last 3 days (P3D) — I want to see if discharge is trending toward flood stage."},{"title":"Drought and low-flow tracking","prompt":"What has the river discharge been at USGS site 09380000 on the Colorado River over the past 30 days (P30D)? I'm tracking low-flow conditions for a water rights analysis."},{"title":"Post-storm runoff assessment","prompt":"Grab the instantaneous flow data from USGS stream gage 02087500 for the past 48 hours (PT48H) — I need to see how much runoff hit the Neuse River after yesterday's storm."}],"resultDescription":"Returns a time series of instantaneous river discharge values (USGS parameter 00060, in cubic feet per second) for the specified NWIS site and duration, sourced directly from USGS Water Services without requiring an API key.","failureModes":["Invalid or non-existent NWIS site number returns no data or an error","Site does not measure parameter 00060 (discharge) — returns empty value set","Malformed ISO 8601 duration string causes request failure","USGS upstream service outage results in timeout or error response","Site has a data gap or sensor outage for the requested period — partial or empty time series returned"],"whenToPreferThis":"Choose this endpoint when you need keyless, pay-per-call access to real-time or recent USGS stream discharge data without managing USGS API credentials. Ideal for hydrology pipelines, flood alerting systems, or environmental monitoring agents that need instantaneous flow readings at specific NWIS gauge sites. Prefer this over direct USGS Water Services calls when operating in a proxied, metered, or agentic payment context (x402).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T06:55:53.536Z","isFirstParty":false,"canonicalSlug":"usgs-stream-gage-flow-via-suverse-proxy-8842470c"}