# WaterPulse Flood Risk API

> WaterPulse Flood Risk API is a paid API for AI agents from waterpulse.theaslangroupllc.com, paid per call via x402, $0.15/call, status unknown (last checked 2026-09-13).

Returns real-time flood risk assessments combining USGS stream gauges, precipitation forecasts, and FEMA flood-zone data for insurance and emergency planning.

## Facts

- Endpoint: GET https://waterpulse.theaslangroupllc.com/api/water/flood-risk
- Price: $0.15/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/waterpulse-flood-risk-api-8e0ceee5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6MHNVqbCC0aOHpEGf-7hF

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability waterpulse-flood-risk-api-8e0ceee5
```

Example prompt: What's the current flood risk for the area around Austin, Texas? I need USGS stream gauge conditions, any precipitation-driven flood threat for the next few days, and the FEMA flood zone context — I'm underwriting a property there.

## When to prefer this

Choose this endpoint when you need a combined, real-time flood risk signal that fuses live USGS stream gauge readings, short-term precipitation forecasts, and FEMA regulatory flood-zone context in a single call — especially for US insurance underwriting, property risk assessment, or emergency planning workflows. Prefer it over raw USGS or FEMA APIs when you need an aggregated, actionable risk score rather than raw hydrological data.

## Known failure modes

- Location outside USGS gauge coverage — no stream gauge data available for remote or ungauged areas
- FEMA flood zone data not available for non-US locations
- Open-Meteo forecast unavailable due to upstream outage — precipitation component may be missing
- Invalid or unparseable location input returns 400 error
- Payment not processed (x402 protocol failure) returns 402 error
- Rate limiting if too many requests in a short window

## How this service works

Real-time flood risk for insurance and emergency-planning agents. Combines USGS stream gauges, Open-Meteo precipitation forecasts, and FEMA flood-zone context into current river conditions and actionable guidance.

## Output

Returns current river and stream conditions from USGS gauges, precipitation-driven flood probability from Open-Meteo forecasts, FEMA flood-zone classification for the queried location, a composite flood risk rating, and actionable guidance for insurance underwriting or emergency response decisions.

## Request schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/waterpulse-flood-risk-api-8e0ceee5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from waterpulse.theaslangroupllc.com](https://www.zero.xyz/host/waterpulse.theaslangroupllc.com/llms.txt)