# HALOWERK kartenwerk Flood Exposure

> HALOWERK kartenwerk Flood Exposure is a paid API for AI agents from karte.halowerk.com, paid per call via x402, $0.006/call, status unknown (last checked 2026-09-14).

Assesses flood risk for a geographic point by combining USGS stream gauge data, nearby watercourse geometry, and terrain depression analysis

## Facts

- Endpoint: POST https://karte.halowerk.com/v1/flood-exposure
- Price: $0.006/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-kartenwerk-flood-exposure-ef1832a7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_o66aq_cJfDKHPlx0lx86t

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 halowerk-kartenwerk-flood-exposure-ef1832a7 -d '<json body>'
```

Example prompt: What's the flood exposure for the property at 37.7749° N, 122.4194° W — look for stream gauges within 15 km and watercourses within 2 km of the point?

## When to prefer this

Choose this endpoint when you need a multi-signal flood risk assessment combining real-time stream gauge levels, physical watercourse proximity, and terrain depression analysis for a specific coordinate. It is particularly suited for property-level due diligence, insurance risk scoring, or site suitability checks in the United States where USGS gauge coverage is strong. Prefer this over static flood map lookups when you need dynamic gauge data combined with terrain and geometry analysis in a single call.

## Known failure modes

- No USGS stream gauges found within the specified gauge_radius_km — returns empty gauge data
- Point falls over ocean or outside USGS coverage area
- Watercourse geometry fetch times out when water_radius_km is too large
- Invalid coordinates outside WGS 84 bounds
- terrain DEM data unavailable for remote or polar locations
- Payment failure via x402 protocol before data is returned

## How this service works

HALOWERK kartenwerk — bezahlte Endpunkte nach x402. Preise in USDC auf Base Mainnet.

## Output

Returns a flood exposure assessment for the given point including: nearby USGS stream gauge readings and distances, proximity to watercourses and water bodies (with closest-point geometry), terrain depression analysis indicating low-lying areas that could accumulate water, and aggregated flood risk indicators derived from these sources

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "lat": {
   "type": "number",
   "maximum": 90,
   "minimum": -90,
   "description": "Latitude, WGS 84."
  },
  "lon": {
   "type": "number",
   "maximum": 180,
   "minimum": -180,
   "description": "Longitude, WGS 84."
  },
  "gauge_radius_km": {
   "type": "number",
   "default": 10,
   "maximum": 25,
   "minimum": 1,
   "description": "How far around the point to look for USGS stream gauges."
  },
  "water_radius_km": {
   "type": "number",
   "default": 1.5,
   "maximum": 3,
   "minimum": 0.2,
   "description": "How far around the point to look for watercourses and water bodies. Kept small on purpose: full geometry is fetched so the closest point on the feature can be computed, and a wide box does not fit the time budget."
  },
  "sink_scan_radius_m": {
   "type": "number",
   "default": 500,
   "maximum": 2000,
   "minimum": 100,
   "description": "Half-width of the square grid sampled for terrain depressions around the point."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-kartenwerk-flood-exposure-ef1832a7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from karte.halowerk.com](https://www.zero.xyz/host/karte.halowerk.com/llms.txt)