# SkyFeed

> Weather forecasts (global), current conditions, US severe-weather alerts, earthquakes, public holidays and a bundled travel check for AI agents. Pay per call in USDC on Base via x402. No API key.

Base URL: https://skyfeed.imac2014ville.workers.dev
OpenAPI: https://skyfeed.imac2014ville.workers.dev/openapi.json
Source: https://github.com/Imac2014Ville/baselens

## Endpoints (GET with query params, or POST with JSON body)
- /forecast ($0.005): Hourly forecast for the next 1-48 hours at a city or lat/lon: temperature, wind, precipitation, humidity, cloud cover, weather symbol, plus a summary. Example: /forecast?city=Tokyo&hours=24
- /current ($0.003): Current conditions (model nowcast for this hour) at a city or lat/lon. Example: /current?city=London
- /alerts ($0.005): Active US National Weather Service alerts by state or lat/lon, sorted by severity, with timing and instructions. Example: /alerts?state=FL
- /earthquakes ($0.003): Recent USGS earthquakes by minimum magnitude and window (up to 168 h), optionally within a radius of a point. Example: /earthquakes?minMagnitude=5&hours=72
- /holidays ($0.002): Public holidays for a country (ISO2) and year, with local names and regional scope. Example: /holidays?country=DE&year=2026
- /travel-check ($0.01): Trip-day bundle for a city: that day's weather, holidays within 3 days, quakes within 300 km in the past week, and risk flags. Example: /travel-check?city=Rome&date=2026-10-12

## Sources
MET Norway Locationforecast (CC BY 4.0), US National Weather Service (public domain), USGS Earthquake Hazards Program (public domain), Nager.Date (MIT).

## Developer guides
- Weather forecast API without an API key, for agents: https://skyfeed.imac2014ville.workers.dev/guides/weather-forecast-api-no-api-key
- US weather alerts API for agents and apps: https://skyfeed.imac2014ville.workers.dev/guides/us-weather-alerts-api
- Earthquake feed API: recent quakes as JSON: https://skyfeed.imac2014ville.workers.dev/guides/earthquake-feed-api

## How to pay
Call an endpoint without payment to receive HTTP 402 with a PAYMENT-REQUIRED header (base64 JSON: scheme exact, network eip155:8453, asset USDC). Use an x402 client (@x402/fetch, x402-axios, or an MCP x402 wallet) to sign and retry. Malformed requests return 400 and lookups that fail return non-2xx, so they are not charged.