{"uid":"cap_EYs02d1bMUgqJrbg7gnbe","slug":"2s-water-gauge-usgs-stream-gauge-data-925b4304","name":"2s Water Gauge — USGS Stream Gauge Data","description":"Real-time US river/stream conditions from a USGS monitoring site. Pass site = the USGS site number (e.g. 01646500 = Potomac River near Washington DC). Returns the latest readings — streamflow (cubic feet/sec), gage height (ft), and water/air temperature where available — with the site name + coordinates and observation time. Useful for flood monitoring, recreation, and hydrology. Source: USGS National Water Information System (keyless, public domain).","url":"https://2s.io/api/water/gauge","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"required":["site"],"properties":{"site":{"type":"string","description":"USGS site number (e.g. 01646500)."}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"site":"01646500"}}},"response":{"data":{"ok":true,"meta":{"site":"01646500","latitude":38.94977778,"siteName":"POTOMAC RIVER NEAR WASH, DC LITTLE FALLS PUMP STA","longitude":-77.12763889},"items":[{"name":"Temperature, water, °C","unit":"deg C","value":24.3,"observedAt":"2019-10-01T12:15:00.000-04:00","parameterCode":"00010"},{"name":"Streamflow, ft³/s","unit":"ft3/s","value":2600,"observedAt":"2026-06-17T16:50:00.000-04:00","parameterCode":"00060"},{"name":"Gage height, ft","unit":"ft","value":2.95,"observedAt":"2026-06-17T16:50:00.000-04:00","parameterCode":"00065"}],"total":3,"source":{"url":"https://waterservices.usgs.gov/","license":"US Government work — public domain.","provider":"US Geological Survey — National Water Information System"}},"meta":{"cost":{"usd":0.0012,"tier":0},"caller":"x402","version":null,"endpoint":"water.gauge","settlement":{"txHash":"0x3358696475d29e7f1033b7b41b769d1fe31b3eca5ab0a88953e71169e144b92b","network":"eip155:8453","success":true}}}},"exampleRequest":{"site":"01646500"},"tags":["x402"],"displayCostAmount":"0.0012","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.0012/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9er4IVlQ8Xy3p3wqzx544","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns real-time streamflow and gage height readings from a USGS water monitoring station by site number","exampleAgentPrompt":"What's the current streamflow and gage height at USGS site 01646500 on the Potomac River near Washington DC?","exampleUseCases":null,"resultDescription":"Returns a JSON object with site metadata (name, lat/lon), an array of current observations (streamflow in ft³/s and gage height in ft with timestamps and parameter codes), total count, and data source attribution from USGS NWIS.","failureModes":["Invalid or nonexistent USGS site number returns error or empty results","Site exists but has no recent observations (sensor offline or decommissioned)","USGS upstream service outage causes failed data retrieval","Missing required 'site' query parameter returns validation error"],"whenToPreferThis":"Use this endpoint when you need authoritative, ground-truth real-time streamflow or water level readings from official USGS monitoring stations. Prefer this over scraped or third-party water data sources when accuracy and provenance matter — data comes directly from NWIS, is public domain, and requires no API key signup. Best for flood monitoring, environmental analysis, hydrology workflows, and any application requiring official US government water gauge readings.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:57:26.536Z","isFirstParty":false}