Weather
A complete weather intelligence library. Current conditions, forecasts, earthquakes, volcanoes, air quality, marine conditions, solar radiation, and historical climate — all from one endpoint set. Plus a natural-language AI reasoning endpoint for cross-domain synthesis.
What is Weather?
Weather + nature intelligence behind x402 micropayments. Eight self-serve GET endpoints return precise, structured data from parallel upstream providers (Open-Meteo ECMWF, 7Timer NOAA GFS, NWS, Met Norway, WeatherAPI, OpenWeatherMap for weather; four FDSN seismic portals for earthquakes; NASA EONET for volcanoes — fastest source wins for redundancy and speed). A ninth endpoint, POST /weather/ask, asks a natural-language question and returns a synthesised, cross-validated answer using DeepSeek reasoning over the live feeds.
Pay per call in USDC, EURC across Base, Arbitrum, Polygon and Avalanche via the x402 micropayment protocol — no subscriptions, no API keys, no wallets to configure for the caller.
Operations
Show all operations
data
| Method | Endpoint | Description | Tier |
|---|---|---|---|
POST | /weather/current | Current weather conditions for any location — temperature, humidity, wind. | basic |
POST | /weather/forecast | 7-day weather forecast — daily highs, lows, precipitation. | basic |
POST | /nature/earthquakes | Recent earthquake activity near a location — queries multiple seismic monitoring portals in parallel. Magnitude, depth, and distance. | basic |
POST | /nature/volcanoes | Recent volcanic activity near a location — global volcano event monitoring. | basic |
POST | /nature/air-quality | Air quality index and pollutants at any location — European AQI, US AQI, PM2.5, PM10, ozone, and NO2. | basic |
POST | /nature/marine | Marine conditions — wave height, sea surface temperature, swell height, and current velocity. | basic |
POST | /nature/solar | Solar radiation data — shortwave and direct radiation, and sunshine duration. | basic |
POST | /climate/historical | Historical weather data from 1940 to present — temperature, precipitation, and more. | basic |
inference
| Method | Endpoint | Description | Tier |
|---|---|---|---|
POST | /weather/ask | Premium multi-source intelligence: ask natural-language questions about weather, earthquakes, volcanoes, or natural events. Queries multiple weather models in parallel and returns the fastest result with cross-validation. | regular |
Workflows
- location_report — Full weather + nature snapshot for one location:
current -> forecast -> air_quality— Pull the three most common feeds together for a single place. - natural_event_brief — Answer an open question about weather or natural hazards:
weather_ask— Single-call AI reasoning over the live feeds.
Data sources
- Open-Meteo — Primary forecast/current source.
- 7Timer — Independent weather source.
- NWS API — US-only.
- Met Norway — ECMWF via Norwegian Met.
- WeatherAPI.com — Requires key (free tier).
- OpenWeatherMap — Requires key (free tier).
- USGS FDSN
- EMSC FDSN
- IRIS FDSN
- GEOFON FDSN
- NASA EONET — Primary volcano source; USGS volcano fallback.
Examples
current
Current conditions in London
{
"latitude": 51.5,
"longitude": -0.12
}weather_ask
Ask about seismic activity near Tokyo
{
"question": "Is there any seismic or volcanic activity near Tokyo?",
"latitude": 35.68,
"longitude": 139.76
}