# Earth
> Earth science intelligence — the librarian model. Ask any natural-language question about weather, climate, air quality, earthquakes, volcanoes, marine conditions, species, biodiversity, sea ice, tides, or solar data. The AI librarian queries the right sources and returns a reasoned answer.

Multi-source Earth intelligence behind x402 micropayments. A single POST /earth/ask endpoint accepts a natural-language question plus an optional style preset (naturalist, climatologist, gardener, geologist, mariner, default) and optional latitude/longitude. DeepSeek detects the topic, fetches live data from 10+ free Earth-monitoring APIs (Open-Meteo, USGS, iNaturalist, GBIF, Sunrise-Sunset.org, OSISAF/MET Norway sea ice, WorldTides), and returns a synthesised, cross-validated answer.

## Pricing
- `premium` tier — **$0.106125** on Base: `/earth/ask`
- Chains: Base, Arbitrum, Polygon, Avalanche, Ethereum, Robinhood, Arc. Per-chain prices in `/.well-known/x402.json`.

## Operations
### inference
- **POST /earth/ask** — Multi-source AI Earth intelligence via DeepSeek. Accepts any natural language question about Earth — weather, air quality, marine conditions, earthquakes, volcanoes, species, seasons, climate, polar ice, and tides. — params: `question` (string)*, `style` (string), `latitude` (number), `longitude` (number) (tier: `premium`)

## Workflows
- **earth_ask** (Answer any Earth/nature/climate question): `ask` — Single-call AI reasoning over 10+ Earth monitoring feeds.

## Data sources
- Open-Meteo (ECMWF/GFS) — Weather, air quality, marine, GFS climate.
- USGS (US Geological Survey) — Earthquakes + volcano alerts.
- iNaturalist (iNaturalist) — Species observations.
- GBIF (Global Biodiversity Information Facility) — Occurrence records.
- Sunrise-Sunset.org (sunrise-sunset.org)
- OSISAF / MET Norway (sea-ice) — Sea ice extent.
- WorldTides (worldtides)

## Free endpoints
- GET `/`, `/health`, `/about`, `/.well-known/x402.json`, `/llms.txt`, `/openapi.json` (standard)
- GET `/earth/feedback` — Return the 50 most recent feedback entries
- POST `/earth/feedback` — Submit feedback (response_id, rating 1-5, optional comment)

## Examples
- `ask` — Ask about the weather in Tokyo: `{"question": "What's the weather in Tokyo?", "style": "naturalist"}`