{"uid":"cap_ztWA7l0MczTGW4v2bIthS","slug":"x402-seller-flood-risk-at-us-river-gauge-f9e05818","name":"x402-seller Flood Risk at US River Gauge","description":"Flood risk at a US river gauge: current water level measured against the official National Weather Service flood stages (action, minor, moderate, major), how many feet remain before each one is reached, and NOAA's own observed and forecast flood category. Answers \"is this river near flooding\". Takes a USGS site number or an NWS gauge ID. Not every gauge has official flood stages.","url":"https://x402-seller.onrender.com/water/flood-risk","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":[],"properties":{"lid":{"type":"string","description":"NWS gauge ID (e.g. BRKM2), as an alternative to site"},"site":{"type":"string","description":"USGS site number (e.g. 01646500)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"site":{"type":["string","null"]},"usgs":{"type":["object","null"]},"gauge":{"type":"object"},"trend":{"type":["string","null"]},"source":{"type":"string"},"forecast":{"type":"object"},"observed":{"type":"object"},"floodStagesFt":{"type":"object"},"nextThreshold":{"type":["object","null"]},"feetBelowStage":{"type":"object"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.31","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.31/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.31","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.31","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Ufv4APKjOYfXwGsW_-cI4","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.31","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns current flood risk at a US river gauge by comparing the live water level to official NWS flood stages (action, minor, moderate, major) and providing NOAA observed and forecast flood categories.","exampleAgentPrompt":"Is the Potomac River at USGS gauge 01646500 close to flooding? Tell me what flood stage it's at and how many feet remain before each NWS threshold — action, minor, moderate, and major.","exampleUseCases":[{"title":"Pre-storm flood risk check","prompt":"Before this weekend's heavy rain, can you check whether the Susquehanna River at USGS gauge 01570500 is already near any NWS flood stages and how many feet of buffer are left before minor flooding?"},{"title":"Emergency response situational awareness","prompt":"We're monitoring the Patuxent River — can you pull the current flood risk for NWS gauge BRKM2 and tell me what category NOAA is observing and forecasting right now?"},{"title":"Automated river monitoring alert","prompt":"Check USGS gauge 01638500 and let me know if it's currently above action stage or within 2 feet of any flood threshold — I need to know if conditions are deteriorating."}],"resultDescription":"Returns a JSON object with the USGS site info, current gauge reading, official NWS flood stage thresholds (action, minor, moderate, major) in feet, how many feet below each stage the river currently is, the next flood threshold to be reached, NOAA's observed and forecast flood categories, and the water level trend. Not every gauge has official flood stages defined.","failureModes":["Gauge not found: invalid USGS site number or NWS lid returns an error or empty result","No flood stages defined: gauge exists but NWS has no official flood stages for it","Stale data: river conditions may lag real-time by minutes to hours depending on reporting frequency","Missing either 'site' or 'lid' parameter: request requires at least one gauge identifier","Payment failure: x402 payment of $0.31 USDC not completed"],"whenToPreferThis":"Use this endpoint when you need official NWS flood stage context — not just raw streamflow numbers — for a specific US river gauge. It is ideal when you want to know how close a river is to action, minor, moderate, or major flood stage rather than just the raw cubic feet per second or gage height. Prefer this over the raw USGS stream conditions endpoint when flood risk assessment and NOAA forecast flood categories are required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:49:05.278Z","isFirstParty":false}