# Global Hazards

Worldwide earthquakes, storms, volcanoes and other natural hazard events from keyless public feeds, plus quake and seismic-wave calculators.

## How to pay

Machine-payable over x402. USDC on: Base (eip155:8453), Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), Polygon (eip155:137), Arbitrum One (eip155:42161).
No accounts. No API keys. No signup. The paying wallet is the account.

## Machine-readable

- OpenAPI: https://global-hazards.x402tookit.com/openapi.json
- x402 manifest: https://global-hazards.x402tookit.com/.well-known/x402
- Catalog (free): https://global-hazards.x402tookit.com/catalog
- Health (free): https://global-hazards.x402tookit.com/health
- Uptime (free): https://global-hazards.x402tookit.com/uptime

## Endpoints (10)

### GET /active-storms — $0.03
Tropical cyclones active now worldwide with computed Saffir-Simpson category, wind, position and distance (EONET, GDACS).
Params: lat?: number, lon?: number, radiusKm?: integer, includeStale?: boolean
Example: https://global-hazards.x402tookit.com/active-storms?includeStale=false

### GET /active-volcanoes — $0.03
Volcanoes with current activity reports worldwide (NASA EONET, GDACS alerts), newest first or nearest to a point.
Params: lat?: number, lon?: number, radiusKm?: integer, limit?: integer
Example: https://global-hazards.x402tookit.com/active-volcanoes?limit=20

### GET /hazard-events-near — $0.03
Natural hazard events near a point: wildfire, storm, volcano, flood and more from NASA EONET and GDACS, nearest first.
Params: lat: number, lon: number, radiusKm?: integer, days?: integer, category?: string
Example: https://global-hazards.x402tookit.com/hazard-events-near?lat=38&lon=-121.5&radiusKm=300&days=14&category=wildfires

### GET /hazard-exposure-screen — $0.05
Hazard screen of a coordinate: quake history plus active wildfire, storm, volcano and flood events within a radius.
Params: lat: number, lon: number, radiusKm?: integer, years?: integer
Example: https://global-hazards.x402tookit.com/hazard-exposure-screen?lat=14&lon=121&radiusKm=300&years=10

### GET /mercalli-scale — $0.02
Modified Mercalli intensity I to XII: what is felt and the typical damage, or the intensity band for a peak ground acceleration.
Params: intensity?: string, pgaPercentG?: number
Example: https://global-hazards.x402tookit.com/mercalli-scale?intensity=VII

### GET /quake-detail — $0.02
One earthquake by USGS event id: magnitude, depth, felt reports, PAGER alert, max intensity, tsunami flag and review status.
Params: eventid: string
Example: https://global-hazards.x402tookit.com/quake-detail?eventid=us6000jlqa

### GET /quake-energy — $0.02
Earthquake magnitude to radiated energy, seismic moment and TNT equivalent, with an optional comparison to a second magnitude.
Params: magnitude: number, compareTo?: number
Example: https://global-hazards.x402tookit.com/quake-energy?magnitude=7&compareTo=5

### GET /quakes-near — $0.02
Earthquakes within a radius of any coordinate worldwide: nearest, largest, counts by size and depth class, with distances.
Params: lat: number, lon: number, radiusKm?: integer, minMagnitude?: number, days?: integer
Example: https://global-hazards.x402tookit.com/quakes-near?lat=35.68&lon=139.69&radiusKm=300&minMagnitude=5&days=365

### GET /quakes-recent — $0.02
Recent earthquakes worldwide above a magnitude, newest or largest first, optional bounding box, with a match count.
Params: minMagnitude?: number, days?: integer, limit?: integer, orderBy?: string, bbox?: string
Example: https://global-hazards.x402tookit.com/quakes-recent?minMagnitude=6&days=30&limit=10&orderBy=magnitude

### GET /seismic-wave-times — $0.02
Estimate P and S wave arrival times and the S-P gap from an epicentral distance or two coordinates, or distance from an S-P lag.
Params: distanceKm?: number, lat1?: number, lon1?: number, lat2?: number, lon2?: number, spLagSeconds?: number, depthKm?: number, vpKmS?: number, vsKmS?: number
Example: https://global-hazards.x402tookit.com/seismic-wave-times?distanceKm=100&depthKm=10

## Terms

Hazard data comes from USGS, NASA EONET and GDACS (UN/EU) public feeds and local computation, provided as is. Feeds lag, can be incomplete or wrong, and are not an official warning service: for emergencies follow your national civil protection, tsunami and meteorological authorities. Distances are to reported points, not affected areas. Not advice for safety-critical or insurance decisions.