# FloodPulse API — floodpulse.waltsoft.net
# Hyperlocal flood, wildfire & heat risk for any US address

## Endpoints
- GET /v1/report?address={address} — Full climate risk report ($15/report)
- GET /v1/flood?address={address} — Flood risk only ($5)
- GET /v1/wildfire?address={address} — Wildfire risk only ($5)
- GET /v1/heat?address={address} — Heat risk only ($5)
- GET /v1/compare?addresses={addr1},{addr2} — Compare multiple addresses ($15)
- GET /v1/pdf?address={address} — PDF report ($15)
- GET /health — Service health check (no auth)

## Authentication
1. x402 Protocol (AI agents): Include payment proof in X-PAYMENT header
2. API Key: Authorization: Bearer fl_live_*
3. Demo: 3/day via landing page /tryit endpoint

## Payment (x402)
- Full report: $15 (15000000 atomic USDC)
- Single hazard: $5 (5000000 atomic USDC)
- Chains: Solana USDC, Base USDC
- Solana payTo: GsKr5q9TmiJQcEgUpBp2X6SmvSg3dnXuw2uxYJxgPTk8
- Base payTo: 0x318A4B4764eb37c3FCBcE434713128143815FD57

## Response Format (report)
{
  "address": "123 Main St, Miami FL 33130",
  "overall_risk_score": 62,
  "flood": { "probability_30yr": 0.26, "fema_zone": "X", "percentile": 73 },
  "wildfire": { "probability_30yr": 0.14, "burn_history": 0, "vegetation_density": "high" },
  "heat": { "extreme_days_2024": 8, "extreme_days_2050": 22, "trend": "+175%" },
  "storm": { "annual_events": 3.2, "tornado_risk": "moderate" },
  "data_sources": ["FEMA NFHL", "USFS LANDFIRE", "NOAA Climate Normals", "USGS 3DEP"]
}

## Data Sources
- FEMA National Flood Hazard Layer (NFHL)
- USFS LANDFIRE (wildfire fuel models)
- NOAA Climate Normals (heat trends)
- USGS 3D Elevation Program (3DEP)
- NASA SEDAC (urban heat islands)