{"uid":"cap_ItgH2VVCCQhGORzg-3GnM","slug":"opendata402-us-river-stream-conditions-8ab4d050","name":"opendata402 US River & Stream Conditions","description":"Latest US river and stream readings from the USGS water data API (15-minute data): discharge (cubic feet per second), gage height (feet) or water temperature for a USGS monitoring site. Use it for flood watching, paddling and fishing conditions, and water-dependent operations. Site number e.g. 01646500 (Potomac River near Washington DC). Data are provisional.","url":"https://opendata402.com/v1/rivers/us?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["site"],"properties":{"site":{"type":"string","pattern":"^\\d{8,15}$","description":"USGS site number."},"parameter":{"enum":["discharge","gage_height","water_temp"],"type":"string","description":"discharge (default), gage_height or water_temp."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_YnnY04tEoLhzRVnoKugTK","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves the latest USGS 15-minute water monitoring data (discharge, gage height, or water temperature) for a specific US river or stream site","exampleAgentPrompt":"What's the current discharge and gage height on the Potomac River near Washington DC? The USGS site number is 01646500.","exampleUseCases":[{"title":"Pre-trip paddling conditions check","prompt":"I'm planning a kayaking trip this weekend — can you check the current discharge and gage height at USGS site 03015500 on the Allegheny River so I know if conditions are safe?"},{"title":"Real-time flood monitoring alert","prompt":"Keep an eye on the current gage height at USGS site 01646500 on the Potomac — is it approaching flood stage right now?"},{"title":"Fishing conditions water temperature","prompt":"What's the current water temperature at USGS monitoring site 02087500 on the Neuse River? I want to know if the trout fishing conditions are good."}],"resultDescription":"Returns the latest provisional 15-minute interval reading for the requested USGS site, including the measurement value (discharge in cfs, gage height in feet, or water temperature), the timestamp of the observation, and the parameter type. Data is marked as provisional and subject to revision.","failureModes":["Invalid or non-existent USGS site number returns an error — site numbers must be 8-15 digits","Parameter enum value not recognized if misspelled (must be discharge, gage_height, or water_temp)","USGS upstream API unavailability causes service errors","Some USGS sites may not measure all three parameter types; requesting an unavailable parameter may return no data","Provisional data may have gaps during sensor outages or maintenance"],"whenToPreferThis":"Use this endpoint when you need real-time or near-real-time US river and stream conditions from an authoritative government source (USGS). It is ideal for flood monitoring, recreational planning (kayaking, fishing, rafting), water-dependent operations, and any application needing streamflow or gage height data at a specific USGS site. Prefer this over generic weather APIs when hydrological precision (cubic feet per second, feet of gage height) from an official monitoring network is required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-15T06:38:39.281Z","isFirstParty":false,"canonicalSlug":"opendata402-us-river-stream-conditions-8ab4d050"}