{ "x402Version": 2, "id": 51387, "slug": "51387", "resource": "https://api.locus.report/api/locus-flood-gauges", "description": "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).", "type": "http", "resourceType": "MCP Tool", "accepts": [ { "scheme": "exact", "network": "eip155:8453", "payTo": "0xF121fbeceC43e1B616D47285851c20d5fC64431b", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "amount": "10000", "amountUsd": 0.01, "maxTimeoutSeconds": 60 }, { "scheme": "exact", "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "payTo": "FBVHMG5PTNW6sNd7uhZBsxhWkwJYRpgk34QcTgDpQdwV", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "amount": "10000", "amountUsd": 0.01, "maxTimeoutSeconds": 60 } ], "outputSchema": { "properties": { "example": { "type": "object" }, "type": { "type": "string" } }, "required": [ "type" ], "type": "object" }, "extensions": { "bazaar": { "info": { "input": { "body": { "address": "1 E Edenton St, Raleigh, NC 27601" }, "bodyType": "json", "method": "POST", "type": "http" }, "output": { "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://waterservices.usgs.gov/nwis/iv/", "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" } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "input": { "additionalProperties": false, "properties": { "body": { "additionalProperties": false, "properties": { "address": { "maxLength": 200, "minLength": 5, "type": "string" }, "latitude": { "maximum": 90, "minimum": -90, "type": "number" }, "longitude": { "maximum": 180, "minimum": -180, "type": "number" }, "radiusMeters": { "maximum": 50000, "minimum": 500, "type": "integer" } }, "type": "object" }, "bodyType": { "enum": [ "json", "form-data", "text" ], "type": "string" }, "method": { "enum": [ "POST", "PUT", "PATCH" ], "type": "string" }, "type": { "const": "http", "type": "string" } }, "required": [ "type", "method", "bodyType", "body" ], "type": "object" }, "output": { "properties": { "example": { "type": "object" }, "type": { "type": "string" } }, "required": [ "type" ], "type": "object" } }, "required": [ "input" ], "type": "object" } }, "builder-code": { "info": { "a": "bc_vz5zyuko" }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "a": { "description": "App builder code", "pattern": "^[a-z0-9_]{1,32}$", "type": "string" }, "s": { "description": "Service builder codes", "items": { "pattern": "^[a-z0-9_]{1,32}$", "type": "string" }, "maxItems": 11, "type": "array" }, "w": { "description": "Wallet builder code", "pattern": "^[a-z0-9_]{1,32}$", "type": "string" } }, "type": "object" } }, "locus.freePreflight": { "coverageBeforeCharge": true, "laneTool": "locus_lane_availability", "mcpUrl": "https://mcp.locus.report/mcp", "recommendedTool": "locus_coverage_check", "skillInstall": "npx @velinussage/locus-agent-skill add", "skillUrl": "https://api.locus.report/.well-known/skill.md", "toolsCallUrl": "https://api.locus.report/tools/call", "toolsListUrl": "https://api.locus.report/tools/list", "unsupportedReturnsFreeDiagnostic": true, "version": 2 }, "offer-receipt": { "info": { "offers": [ { "acceptIndex": 0, "format": "eip712", "payload": { "amount": "10000", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "network": "eip155:8453", "payTo": "0xF121fbeceC43e1B616D47285851c20d5fC64431b", "resourceUrl": "https://api.locus.report/api/locus-flood-gauges", "scheme": "exact", "validUntil": 1791440865, "version": 1 }, "signature": "0xedd49fea5e58cfea2c287758571ee00db1d325f9b068abfc334fcedad949b2391b4ed3825f1c15650f98e71210176d0c96942778d55de5b364536029e47793651c" } ] }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "offers": { "items": { "properties": { "acceptIndex": { "type": "integer" }, "format": { "type": "string" }, "payload": { "properties": { "amount": { "type": "string" }, "asset": { "type": "string" }, "network": { "type": "string" }, "payTo": { "type": "string" }, "resourceUrl": { "type": "string" }, "scheme": { "type": "string" }, "validUntil": { "type": "integer" }, "version": { "type": "integer" } }, "required": [ "version", "resourceUrl", "scheme", "network", "asset", "payTo", "amount" ], "type": "object" }, "signature": { "type": "string" } }, "required": [ "format", "signature" ], "type": "object" }, "type": "array" } }, "required": [ "offers" ], "type": "object" } } }, "tags": [ "bazaar", "builder-code", "locus.freePreflight", "offer-receipt" ], "sourceHost": "api.locus.report", "lastUpdated": "2026-10-08T06:26:45.954Z", "quality": { "calls30d": 4, "uniquePayers30d": 2, "lastCalledAt": "2026-10-08T06:26:43.852Z" }, "metadata": { "extensions": { "bazaar": { "info": { "input": { "body": { "address": "1 E Edenton St, Raleigh, NC 27601" }, "bodyType": "json", "method": "POST", "type": "http" }, "output": { "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://waterservices.usgs.gov/nwis/iv/", "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" } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "input": { "additionalProperties": false, "properties": { "body": { "additionalProperties": false, "properties": { "address": { "maxLength": 200, "minLength": 5, "type": "string" }, "latitude": { "maximum": 90, "minimum": -90, "type": "number" }, "longitude": { "maximum": 180, "minimum": -180, "type": "number" }, "radiusMeters": { "maximum": 50000, "minimum": 500, "type": "integer" } }, "type": "object" }, "bodyType": { "enum": [ "json", "form-data", "text" ], "type": "string" }, "method": { "enum": [ "POST", "PUT", "PATCH" ], "type": "string" }, "type": { "const": "http", "type": "string" } }, "required": [ "type", "method", "bodyType", "body" ], "type": "object" }, "output": { "properties": { "example": { "type": "object" }, "type": { "type": "string" } }, "required": [ "type" ], "type": "object" } }, "required": [ "input" ], "type": "object" } }, "builder-code": { "info": { "a": "bc_vz5zyuko" }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "a": { "description": "App builder code", "pattern": "^[a-z0-9_]{1,32}$", "type": "string" }, "s": { "description": "Service builder codes", "items": { "pattern": "^[a-z0-9_]{1,32}$", "type": "string" }, "maxItems": 11, "type": "array" }, "w": { "description": "Wallet builder code", "pattern": "^[a-z0-9_]{1,32}$", "type": "string" } }, "type": "object" } }, "locus.freePreflight": { "coverageBeforeCharge": true, "laneTool": "locus_lane_availability", "mcpUrl": "https://mcp.locus.report/mcp", "recommendedTool": "locus_coverage_check", "skillInstall": "npx @velinussage/locus-agent-skill add", "skillUrl": "https://api.locus.report/.well-known/skill.md", "toolsCallUrl": "https://api.locus.report/tools/call", "toolsListUrl": "https://api.locus.report/tools/list", "unsupportedReturnsFreeDiagnostic": true, "version": 2 }, "offer-receipt": { "info": { "offers": [ { "acceptIndex": 0, "format": "eip712", "payload": { "amount": "10000", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "network": "eip155:8453", "payTo": "0xF121fbeceC43e1B616D47285851c20d5fC64431b", "resourceUrl": "https://api.locus.report/api/locus-flood-gauges", "scheme": "exact", "validUntil": 1791440865, "version": 1 }, "signature": "0xedd49fea5e58cfea2c287758571ee00db1d325f9b068abfc334fcedad949b2391b4ed3825f1c15650f98e71210176d0c96942778d55de5b364536029e47793651c" } ] }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "offers": { "items": { "properties": { "acceptIndex": { "type": "integer" }, "format": { "type": "string" }, "payload": { "properties": { "amount": { "type": "string" }, "asset": { "type": "string" }, "network": { "type": "string" }, "payTo": { "type": "string" }, "resourceUrl": { "type": "string" }, "scheme": { "type": "string" }, "validUntil": { "type": "integer" }, "version": { "type": "integer" } }, "required": [ "version", "resourceUrl", "scheme", "network", "asset", "payTo", "amount" ], "type": "object" }, "signature": { "type": "string" } }, "required": [ "format", "signature" ], "type": "object" }, "type": "array" } }, "required": [ "offers" ], "type": "object" } } } }, "liveness": { "reliability": null }, "verified": false, "featured": false, "provider": { "host": "api.locus.report", "manifest_name": "api.locus.report", "source": "cdp-mirror", "source_manifest_url": "https://api.cdp.coinbase.com/platform/v2/x402/discovery/resources", "submitted_at": "2026-10-14T01:15:01.050Z" }, "exampleResponse": { "example": {}, "type": "string" } }