{"uid":"cap_9Xg11esL8sHnop5EahXE8","slug":"waterpulse-flood-risk-api-775afe17","name":"WaterPulse Flood Risk API","description":"Real-time water intelligence API. Groundwater levels, streamflow, drought status, water quality, aquifer analysis, flood risk, and global water stress — pay-per-query via x402.","url":"https://waterpulse-henna.vercel.app/api/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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"lang":{"type":"string","description":"en | es | fr | de | ja | zh | ko | pt | ar (default: en)"},"state":{"type":"string","description":"Two-letter US state code for USGS data enrichment — e.g. TN | IA | TX"},"location":{"type":"string","description":"City, county, or river name — e.g. \"Nashville TN\" | \"Mississippi River Iowa\" | \"Houston Harris County\""}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"errors":{"type":"object","description":"Documented error responses, keyed by HTTP status code","additionalProperties":{"type":"object","required":["description"],"properties":{"example":{"type":"object"},"description":{"type":"string"}}}},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"query_summary":{"state":"TN","location":"Nashville TN","risk_horizon":"72 hours"},"risk_assessment":{"72h_outlook":"Moderate — 40-60% probability of reaching action stage","current_risk":"Low-Moderate","historical_context":"Cumberland River has exceeded 40 ft (flood stage) 6 times since 2000, including catastrophic 2010 event (51.9 ft)"},"upstream_factors":{"dam_releases":"Army Corps releasing 22,000 cfs at Old Hickory — elevated downstream levels expected","soil_saturation":"High (>85%) — upstream of Cordell Hull Dam","precipitation_72h_in":2.1},"property_guidance":{"nfip_note":"22% of Nashville flood claims come from outside high-risk zones. Consider coverage if within 1 mile of Cumberland or major tributary.","fema_zones_at_risk":["AE","AO"],"preparation_checklist":["Move valuables above ground level","Test sump pump","Locate flood shutoffs","Review NFIP policy limits"]},"current_conditions":{"stage_ft":28.4,"condition":"Below action stage — monitoring recommended","primary_river":"Cumberland River","flood_stage_ft":40,"action_stage_ft":30,"pct_of_flood_stage":71}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.15","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.15/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_VSCAzT63aCu8fmm1XL2Cx","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.15","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns real-time flood risk assessments by combining USGS stream gauge data, Open-Meteo precipitation forecasts, and FEMA flood-zone context for a given location","exampleAgentPrompt":"What's the current flood risk near the Sacramento River at Sacramento, CA — I need the USGS gauge conditions, upcoming precipitation outlook, and FEMA flood zone context so I can decide whether to issue a flood warning for emergency planning.","exampleUseCases":null,"resultDescription":"Returns current river conditions from USGS stream gauges (flow rate, flood stage status), short-term precipitation forecasts from Open-Meteo, FEMA flood zone classification for the area, a composite flood risk level (e.g. low/moderate/high/extreme), and actionable guidance for insurance or emergency-planning decisions.","failureModes":["Location outside USGS gauge coverage returns no gauge data or partial results","FEMA flood zone data unavailable for non-US locations","Open-Meteo forecast unavailable for remote or offshore areas","Invalid or unrecognized coordinates return a 400 error","Upstream data source outage causes degraded or stale results","Rate limiting or payment failure returns 402 or 429 error"],"whenToPreferThis":"Choose this endpoint when you need a synthesized, multi-source flood risk assessment that combines real-time stream gauge readings, precipitation forecasts, and regulatory flood zone context in a single call. Ideal for insurance underwriting, emergency planning agents, or property risk evaluation where actionable guidance is needed rather than raw hydrological data alone. Prefer over raw USGS or Open-Meteo APIs when you need integrated risk scoring rather than individual data streams.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:41:38.730Z","isFirstParty":false}