{"uid":"cap_JS3HuTMglWdl0NHL9fCza","slug":"usgs-water-data-api-via-2s-io-0d1ea5e1","name":"USGS Water Data API via 2s.io","description":"Real-time water data from USGS NWIS stream / river / groundwater gauges within a bounding box around lat/lon. Returns each site's latest reading per requested variable: streamflow (00060, ft³/s), gage height (00065, ft), water temperature (00010, °C), precipitation (00045, in), and others. Each reading: site code + name, lat/lon, variable name + description + unit, value (or null if no data / sentinel), qualifier codes (e.g., 'P' = provisional, 'A' = approved), observed timestamp. Free public-domain data from waterservices.usgs.gov.","url":"https://2s.io/api/gov/usgs-water","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":{"type":"object","required":["lat","lon"],"properties":{"lat":{"type":"number","maximum":90,"minimum":-90,"description":"Center latitude (decimal degrees)."},"lon":{"type":"number","maximum":180,"minimum":-180,"description":"Center longitude (decimal degrees)."},"limit":{"type":"integer","default":25,"maximum":100,"minimum":1,"description":"Max readings to return (1-100). Default 25."},"radius":{"type":"number","default":0.5,"maximum":2,"minimum":0.05,"description":"Half-side of bounding box, in decimal degrees. Default 0.5 (~35 mi)."},"variables":{"type":"string","description":"Comma-separated USGS parameter codes (5-digit). Default \"00060,00065,00010\" (streamflow, gage height, water temp)."}},"additionalProperties":false}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"lat":40.015,"lon":-105.27,"limit":10,"radius":0.5,"variables":"00060,00065,00010"}}},"response":{"data":{"ok":true,"meta":{"bbox":{"east":-104.77,"west":-105.77,"north":40.515,"south":39.515},"query":{"lat":40.015,"lon":-105.27,"limit":10,"variables":["00060","00065","00010"],"radiusDegrees":0.5}},"items":[{"unit":"ft3/s","value":0.33,"latitude":39.59611111,"siteCode":"06709740","siteName":"LEE GULCH AT LITTLETON, CO","longitude":-105.01602778,"agencyCode":"USGS","observedAt":"2026-06-11T21:50:00.000-06:00","qualifiers":["P"],"noDataValue":-999999,"variableCode":"00060","variableName":"Streamflow, ft³/s","variableDescription":"Discharge, cubic feet per second"},{"unit":"ft","value":8.4,"latitude":39.59611111,"siteCode":"06709740","siteName":"LEE GULCH AT LITTLETON, CO","longitude":-105.01602778,"agencyCode":"USGS","observedAt":"2026-06-11T21:50:00.000-06:00","qualifiers":["P"],"noDataValue":-999999,"variableCode":"00065","variableName":"Gage height, ft","variableDescription":"Gage height, feet"},{"unit":"ft3/s","value":0.24,"latitude":39.60011111,"siteCode":"06709910","siteName":"DUTCH CR AT PLATTE CANYON DRIVE NEAR LITTLETON, CO","longitude":-105.04192222,"agencyCode":"USGS","observedAt":"2026-06-11T21:50:00.000-06:00","qualifiers":["P"],"noDataValue":-999999,"variableCode":"00060","variableName":"Streamflow, ft³/s","variableDescription":"Discharge, cubic feet per second"},{"unit":"ft","value":8.2,"latitude":39.60011111,"siteCode":"06709910","siteName":"DUTCH CR AT PLATTE CANYON DRIVE NEAR LITTLETON, CO","longitude":-105.04192222,"agencyCode":"USGS","observedAt":"2026-06-11T21:50:00.000-06:00","qualifiers":["P"],"noDataValue":-999999,"variableCode":"00065","variableName":"Gage height, ft","variableDescription":"Gage height, feet"},{"unit":"ft3/s","value":0.79,"latitude":39.563333,"siteCode":"06710150","siteName":"BIG DRY CREEK BELOW C-470 AT HIGHLANDS RANCH, CO","longitude":-104.927222,"agencyCode":"USGS","observedAt":"2026-06-11T22:30:00.000-06:00","qualifiers":["P"],"noDataValue":-999999,"variableCode":"00060","variableName":"Streamflow, ft³/s","variableDescription":"Discharge, cubic feet per second"},{"unit":"ft","value":1.61,"latitude":39.563333,"siteCode":"06710150","siteName":"BIG DRY CREEK BELOW C-470 AT HIGHLANDS RANCH, CO","longitude":-104.927222,"agencyCode":"USGS","observedAt":"2026-06-11T22:30:00.000-06:00","qualifiers":["P"],"noDataValue":-999999,"variableCode":"00065","variableName":"Gage height, ft","variableDescription":"Gage height, feet"},{"unit":"ft3/s","value":25.7,"latitude":39.63248027,"siteCode":"06710247","siteName":"SOUTH PLATTE RIVER BELOW UNION AVE, AT ENGLEWOOD,C","longitude":-105.01501425,"agencyCode":"USGS","observedAt":"2026-06-11T21:45:00.000-06:00","qualifiers":["P"],"noDataValue":-999999,"variableCode":"00060","variableName":"Streamflow, ft³/s","variableDescription":"Discharge, cubic feet per second"},{"unit":"ft","value":11.02,"latitude":39.63248027,"siteCode":"06710247","siteName":"SOUTH PLATTE RIVER BELOW UNION AVE, AT ENGLEWOOD,C","longitude":-105.01501425,"agencyCode":"USGS","observedAt":"2026-06-11T21:45:00.000-06:00","qualifiers":["P"],"noDataValue":-999999,"variableCode":"00065","variableName":"Gage height, ft","variableDescription":"Gage height, feet"},{"unit":"ft3/s","value":12.7,"latitude":39.633167,"siteCode":"06710385","siteName":"BEAR CREEK ABOVE EVERGREEN, CO","longitude":-105.336944,"agencyCode":"USGS","observedAt":"2026-06-11T22:00:00.000-06:00","qualifiers":["P"],"noDataValue":-999999,"variableCode":"00060","variableName":"Streamflow, ft³/s","variableDescription":"Discharge, cubic feet per second"},{"unit":"ft","value":4.28,"latitude":39.633167,"siteCode":"06710385","siteName":"BEAR CREEK ABOVE EVERGREEN, CO","longitude":-105.336944,"agencyCode":"USGS","observedAt":"2026-06-11T22:00:00.000-06:00","qualifiers":["P"],"noDataValue":-999999,"variableCode":"00065","variableName":"Gage height, ft","variableDescription":"Gage height, feet"}],"total":null,"source":{"url":"https://waterservices.usgs.gov/","license":"Public domain (US government records)","provider":"USGS National Water Information System (NWIS)"}},"meta":{"cost":{"usd":0.0024,"tier":0},"caller":"x402","version":null,"endpoint":"gov.usgs-water","settlement":{"txHash":"0x904e9cad6dc0686d414e6f1c7c252a7ff522e3ace0368013662a2b0187cd6ee0","network":"eip155:8453","success":true}}}},"exampleRequest":{"lat":40.015,"lon":-105.27,"limit":10,"radius":0.5,"variables":"00060,00065,00010"},"tags":["x402"],"displayCostAmount":"0.0024","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.0024/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_PP9peztsMnlLoymUM0Zx7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.006","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns real-time USGS water monitoring readings (streamflow, gage height, water temperature, etc.) for monitoring stations near a given geographic coordinate.","exampleAgentPrompt":"What are the current streamflow and gage height readings from USGS monitoring stations within about 30 miles of Boulder, Colorado (40.015, -105.27)? Return up to 10 results.","exampleUseCases":null,"resultDescription":"A JSON array of water monitoring readings from USGS stations within the specified bounding box, each including the site name, site code, variable name and description, measured value, unit, observation timestamp, and qualifiers. Also includes metadata about the bounding box and query parameters, plus source attribution (provider, URL, license).","failureModes":["No USGS stations found within the specified radius — returns empty items array","Invalid lat/lon values outside allowed range — schema validation error","Invalid USGS parameter codes not matching 5-digit pattern — schema rejection","Radius too large (>2 degrees) or too small (<0.05) — validation error","USGS upstream service unavailable — may return error or stale data","Payment failure via x402 — 402 response before data is returned"],"whenToPreferThis":"Use this endpoint when you need real-time hydrological data (streamflow, gage height, water temperature) from official U.S. government USGS monitoring stations, scoped to a geographic area defined by a center coordinate and radius. Prefer this over generic weather APIs when the user specifically needs river/stream/water body measurements rather than atmospheric conditions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:59:14.752Z","isFirstParty":false}