# Aviation
> Aviation intelligence: live flight tracking, METAR/TAF weather, jet streams, airport data, PIREPs, SIGMETs, G-AIRMETs, winds aloft, NOTAMs, aircraft specs, and route planning. Multi-source AI reasoning endpoint for natural-language aviation questions.

Aviation + preflight intelligence behind x402 micropayments. Eleven self-serve GET endpoints cover ADS-B live aircraft positions, METAR/TAF weather, airport data, upper-atmosphere jet streams and winds aloft, NOTAMs, PIREPs, SIGMETs, G-AIRMETs, aircraft specifications, and route distance/time estimation. A twelfth endpoint, POST /aviation/ask, answers natural-language aviation questions with DeepSeek reasoning over the same live feeds.

## Pricing
- `basic` tier — **$0.006125** on Base: `/aviation/aircraft`, `/aviation/airport`, `/aviation/flights`, `/aviation/gairmets`, `/aviation/jetstream`, `/aviation/notams`, `/aviation/pireps`, `/aviation/route`, `/aviation/sigmets`, `/aviation/weather`, `/aviation/winds`
- `regular` tier — **$0.056125** on Base: `/aviation/ask`
- Chains: Base, Arbitrum, Polygon, Avalanche. Per-chain prices in `/.well-known/x402.json`.

## Operations
### data
- **GET /aviation/aircraft** — Aircraft specifications lookup by ICAO type designator with performance data. (tier: `basic`)
- **GET /aviation/airport** — Airport information — ICAO lookup including runways, frequencies, and services. — params: `icao` (string)* (tier: `basic`)
- **GET /aviation/flights** — Live aircraft positions near a location (ADS-B, global). — params: `latitude` (number)*, `longitude` (number)*, `radius_km` (integer) (tier: `basic`)
- **GET /aviation/gairmets** — Graphical AIRMETs (G-AIRMETs) — icing, turbulence, and IFR condition advisories. (tier: `basic`)
- **GET /aviation/jetstream** — Multi-level upper atmosphere wind and temperature data from 850hPa through 200hPa. — params: `latitude` (number)*, `longitude` (number)* (tier: `basic`)
- **GET /aviation/notams** — Active NOTAMs (Notices to Air Missions) for an airport — with ICAO-formatted messages, plain-language text, and parsed fields. — params: `icao` (string)* (tier: `basic`)
- **GET /aviation/pireps** — Pilot Reports (PIREPs) near a station — aircraft type, flight level, weather, icing, and turbulence reports. — params: `icao` (string)*, `distance` (integer), `hours` (integer) (tier: `basic`)
- **GET /aviation/route** — Route distance and estimated flight time between two airports — with optional aircraft type lookup. — params: `from` (string)*, `to` (string)* (tier: `basic`)
- **GET /aviation/sigmets** — Significant Meteorological Information (SIGMETs) — domestic and international convective, turbulence, and icing advisories. (tier: `basic`)
- **GET /aviation/weather** — Aviation weather (METAR + TAF) at an airport. — params: `icao` (string)* (tier: `basic`)
- **GET /aviation/winds** — Winds aloft at multiple pressure levels (850hPa through 200hPa) — temperature, wind speed, and direction at each level. — params: `latitude` (number)*, `longitude` (number)* (tier: `basic`)

### inference
- **POST /aviation/ask** — Premium multi-source aviation intelligence: ask natural-language questions about flights, aviation weather (METAR/TAF), jet streams, and airports. Returns a reasoned answer by synthesising multiple live data sources in parallel. — params: `question` (string)*, `icao` (string), `latitude` (number), `longitude` (number) (tier: `regular`)

## Workflows
- **preflight_brief** (Pre-flight weather + NOTAM + route brief for a departure/arrival): `weather -> notams -> route` — Pull weather, NOTAMs and route distance together.
- **aviation_ask** (Answer an open aviation question in natural language): `ask` — Single-call AI reasoning over the live feeds.

## Data sources
- ADS-B flight tracking (OpenSky Network) — Live aircraft positions.
- Aviation weather (AviationWeather.gov) — METAR/TAF, PIREPs, SIGMETs, G-AIRMETs.
- Upper atmosphere (Open-Meteo) — Jet streams and winds aloft 850hPa-200hPa.
- NOTAMs (FAA NOTAM Search)
- PIREPs (AviationWeather.gov)
- SIGMETs (AviationWeather.gov)
- G-AIRMETs (AviationWeather.gov)
- Aircraft specs (Aircraft data)

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

## Examples
- `aircraft` — aircraft: `{"type": "B738"}`
- `airport` — airport: `{"icao": "EGLL"}`
- `flights` — flights: `{"latitude": 51.5, "longitude": -0.12, "radius_km": 100}`
- `jetstream` — jetstream: `{"latitude": 51.5, "longitude": -0.12}`