← Back to directory

USGS stream and river gauges with latest stage and flow, plus NOAA/NWS threshold...

https://api.locus.report/api/locus-flood-gauges

Overview

USGS stream and river gauges with latest stage and flow, plus NOAA/NWS threshold metadata within the search radius, for buyer, owner and lender agents. Returns the same records as locus_flood_gauges. Use this when your client can only call paid x402 routes. Use locus_flood_gauges instead when you can call Locus free tools (REST tools/call or MCP).

Protocol x402 (POST)
Price $0.01
Payment Asset USD Coin
Payment Network eip155:8453
Category tools/search
Provider locus
Source bazaar
Indexed 2026-09-08 21:13:51

Health

Status degraded
Latency (p50) 725ms
Uptime (30d) 98.5%
Reliability Score 84.2/100
Last Checked 2026-10-31 07:14:16
Last Healthy 2026-10-27 20:16:37
Consecutive Failures 1

x402 Payment Validation

Payment Requirements Invalid
Asset Verified —
Facilitator —

Input Schema

{ "body": { "address": "1 E Edenton St, Raleigh, NC 27601" }, "bodyType": "json", "method": "POST", "type": "http" }

Output Schema

{ "example": { "caveats": [ "Gauge observations are point measurements at stream/river stations, not a parcel flood prediction or insurance determination.", "Nearby gauges may be on a different drainage basin than the property; verify watershed relevance with local floodplain or stormwater staff." ], "componentStatus": [ { "component": "usgs_observations", "status": "ok" }, { "component": "nws_nwps_thresholds", "status": "ok" } ], "gauges": [ { "agency": "USGS", "distanceMeters": 1531, "name": "PIGEON HOUSE CR AT DORTCH STREET AT RALEIGH, NC", "nws": { "forecast": { "floodCategory": "fcst_not_current" }, "gaugeId": "0208732544", "lid": "DRCN7", "observed": { "floodCategory": "no_flooding", "stage": 1.99, "unit": "ft", "validTime": "2026-09-23T00:10:00Z" }, "officialUrl": "https://water.noaa.gov/gauges/DRCN7", "thresholds": { "action": 14, "flood": 15, "major": 20, "minor": 15, "moderate": 18 }, "usgsId": "0208732544" }, "observations": [ { "observedAt": "2026-09-22T20:55:00.000-04:00", "parameterCode": "00065", "parameterName": "Gage height, ft", "qualifiers": [ "P" ], "unit": "ft", "value": 1.96 } ], "officialUrl": "https://waterdata.usgs.gov/monitoring-location/0208732544", "point": { "latitude": 35.793892, "longitude": -78.642597 }, "siteId": "0208732544" }, { "agency": "USGS", "distanceMeters": 1614, "name": "PIGEON HOUSE CR AT CAMERON VILLAGE AT RALEIGH, NC", "nws": { "forecast": { "floodCategory": "fcst_not_current" }, "gaugeId": "0208732534", "lid": "PIGN7", "observed": { "floodCategory": "no_flooding", "stage": 1.41, "unit": "ft", "validTime": "2026-09-23T00:30:00Z" }, "officialUrl": "https://water.noaa.gov/gauges/PIGN7", "thresholds": { "action": 5, "flood": 6, "major": 11, "minor": 6, "moderate": 8 }, "usgsId": "0208732534" }, "observations": [ { "observedAt": "2026-09-22T21:00:00.000-04:00", "parameterCode": "00060", "parameterName": "Streamflow, ft³/s", "qualifiers": [ "P" ], "unit": "ft3/s", "value": 0.03 }, { "observedAt": "2026-09-22T21:00:00.000-04:00", "parameterCode": "00065", "parameterName": "Gage height, ft", "qualifiers": [ "P" ], "unit": "ft", "value": 1.41 } ], "officialUrl": "https://waterdata.usgs.gov/monitoring-location/0208732534", "point": { "latitude": 35.7875, "longitude": -78.6547222 }, "siteId": "0208732534" } ], "note": "Awareness/diagnostic only. Full briefs are x402-paid. Agents can discover live free tools at https://api.locus.report/tools/list and paid tools, prices, and manifests at https://api.locus.report/.well-known/ai-tool/index.json.", "ok": true, "point": { "latitude": 35.780418000003195, "longitude": -78.63910200000142 }, "provenance": { "coverage": "United States where USGS/NWS gauges publish observations or threshold metadata", "nwsServiceUrl": "https://api.water.noaa.gov/nwps/v1/", "nwsSourcePage": "https://water.noaa.gov/about/api", "source": "USGS National Water Information System + NOAA/NWS National Water Prediction Service", "usgsServiceUrl": "https://api.waterdata.usgs.gov/ogcapi/v0/collections/latest-continuous/items", "usgsSourcePage": "https://www.usgs.gov/tools/usgs-water-data-apis" }, "radiusMeters": 10000, "verifyNext": [ { "source": "USGS", "step": "Open each USGS monitoring-location page for current observations and station metadata.", "url": "https://waterdata.usgs.gov/monitoring-location/" }, { "source": "NOAA/NWS", "step": "Open the matching NOAA/NWS NWPS gauge page for flood-category thresholds and forecasts where available.", "url": "https://water.noaa.gov/" } ] }, "type": "json" }