# FloodPulse — Full API Documentation

### GET /v1/report
- Price: $15.00 (15000000 atomic USDC)
- Full natural-hazard report for a US address: FEMA flood zone and 30-year odds, RODA terrain and HAND, NOAA county extreme-heat history, FEMA NRI wildfire/heat/storm ratings and percentiles.
- Params: address, or lat + lon

### GET /v1/flood
- Price: $5.00 (5000000 atomic USDC)
- Flood risk for a US address: FEMA zone and SFHA status, annual and 30-year flood odds, elevation and height above nearest drainage (RODA), FEMA NRI inland and coastal flooding ratings.
- Params: address, or lat + lon

### GET /v1/wildfire
- Price: $5.00 (5000000 atomic USDC)
- Wildfire risk for a US address: FEMA National Risk Index wildfire rating, national percentile, annual burn probability and expected annual loss for the census tract.
- Params: address, or lat + lon

### GET /v1/heat
- Price: $5.00 (5000000 atomic USDC)
- Extreme-heat history for a US address: days over 90F/95F per year from NOAA nClimGrid-Daily (county, 1981-2024), decade change and trend, plus the FEMA NRI heat-wave rating.
- Params: address, or lat + lon

### GET /v1/compare
- Price: $15.00 (15000000 atomic USDC)
- Compare 2-3 US addresses: FEMA flood zone, 30-year flood odds and FEMA NRI composite and per-hazard ratings side by side.
- Params: addresses (2-3 US addresses separated by '|')

### GET /tryit
- Free. A static, real sample report for 1700 Convention Center Dr, Miami Beach, FL 33139 (generated 2026-10-01).

## 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.

## Errors (never charged)
- 400 bad or missing parameters (checked before payment)
- 404 address not found by the Census geocoder
- 503 a public source is temporarily unavailable

## Authentication
1. x402: call without payment, read the 402 (body or PAYMENT-REQUIRED header), sign, retry with PAYMENT-SIGNATURE or X-PAYMENT.
2. API key: Authorization: Bearer fl_live_YOUR_KEY (buy at https://floodpulse.waltsoft.net)

## Provider
Waltsoft · https://waltsoft.net