# FloodPulse

> Flood, wildfire, heat and storm risk for any US address, from FEMA, NOAA and Registry of Open Data on AWS sources. Pay per query with x402; charged only for 2xx answers.

## Endpoints

- GET /v1/report?address=... — Full report ($15)
- GET /v1/flood?address=... — Flood zone, 30-year odds, terrain, NRI flood ratings ($5)
- GET /v1/wildfire?address=... — NRI wildfire rating, percentile, burn probability ($5)
- GET /v1/heat?address=... — NOAA county extreme-heat history + NRI heat wave ($5)
- GET /v1/compare?addresses=a|b — Compare 2-3 addresses ($15)
- GET /tryit — Static sample report (free)
- lat and lon may replace address on every single-address endpoint.

## Data sources
- US Census Geocoder (TIGER/Line): address -> coordinates and census tract
- FEMA National Flood Hazard Layer: flood zone, Special Flood Hazard Area, base flood elevation
- FEMA National Risk Index (census tract; the release used is reported in every response): hazard ratings, national percentiles, annualized frequency, expected annual loss
- Copernicus GLO-30 DEM (Registry of Open Data on AWS): surface elevation
- Global 30m Height Above Nearest Drainage (Registry of Open Data on AWS): height above nearest drainage
- NOAA nClimGrid-Daily county averages (Registry of Open Data on AWS): daily maximum temperature 1981-2024

## Limits
- Observed history and current FEMA ratings only: no forward projections.
- 30-year flood odds are bounds derived from the FEMA zone's annual chance; null where FEMA gives no bound.
- Heat history is a county average (NOAA nClimGrid-Daily), contiguous US only.
- Elevation and HAND come from a 30 m surface model; buildings and trees can distort them in towns.

## Payment
- x402 v2. Base: eip155:8453 USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 payTo 0x318A4B4764eb37c3FCBcE434713128143815FD57
- Solana: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp USDC EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v payTo GsKr5q9TmiJQcEgUpBp2X6SmvSg3dnXuw2uxYJxgPTk8
- API key: Authorization: Bearer fl_live_YOUR_KEY