Get TAF weather forecasts for any airport via FlightAware — $0.004 per request, pay with USDC on Tempo.
What it does
This endpoint returns Terminal Aerodrome Forecast (TAF) data for a specific airport, sourced from FlightAware's AeroAPI. Supply an ICAO or IATA airport code as the path parameter `{id}`, and receive structured forecast periods plus the raw TAF text. Optional query parameters include `timestamp` (ISO 8601), `return_nearby_weather` (boolean to include nearby station data), and `temperature_units` (fahrenheit or celsius).
The endpoint is part of StableTravel, a pay-per-request travel API suite that wraps Amadeus and FlightAware data behind MPP/x402 micropayments. No API keys or subscriptions are required — payment via USDC on Tempo (chainId 4217) serves as authentication. The price for this endpoint is $0.004 per call (4000 base units of pathUSD with 6 decimals). The response includes `airport_code`, `timeframe`, a `forecast` array of structured forecast periods, and `raw_forecast` containing the original TAF strings.
The endpoint uses HTTP GET and is live, returning a 402 MPP payment challenge to unauthenticated callers. It pairs well with the companion METAR observations endpoint (`/api/flightaware/airports/{id}/weather/observations`) at the same price point for a complete airport weather picture.
Capabilities
Use cases
- —Retrieve TAF forecasts before flight departure to assess expected conditions
- —Build pre-flight briefing tools that combine METAR and TAF data
- —Monitor weather forecasts at destination airports for delay prediction
- —Integrate airport weather into autonomous travel-planning agents
- —Power aviation dashboards with structured forecast data
Fit
Best for
- —AI agents that need programmatic airport weather forecasts without API key management
- —Aviation applications requiring structured TAF data on demand
- —Travel planning workflows that check destination weather conditions
- —Low-volume or bursty weather lookups where per-request pricing beats subscriptions
Not for
- —High-frequency weather polling (cost adds up; consider direct FlightAware subscription)
- —Non-aviation general weather forecasts (TAF is aviation-specific)
- —Historical weather analysis (this returns current/near-future TAF only)
Quick start
npx agentcash fetch "https://stabletravel.dev/api/flightaware/airports/KJFK/weather/forecast?temperature_units=celsius"Example
Response
{
"forecast": [
{
"clouds": [
{
"type": "BKN",
"altitude": 3000
}
],
"timestamp": "2025-07-15T12:00:00Z",
"conditions": null,
"visibility": 6,
"wind_speed": 12,
"wind_direction": 220
}
],
"timeframe": "2025-07-15T12:00:00Z/2025-07-16T18:00:00Z",
"airport_code": "KJFK",
"raw_forecast": [
"TAF KJFK 151130Z 1512/1618 22012KT P6SM BKN030"
]
}Endpoint
Quality
Full OpenAPI 3.1 schema with response shape, clear pricing ($0.004), documented parameters, and a live 402 MPP challenge confirming the endpoint is operational. Minor deductions: no example response in the spec, and the response forecast item schema uses untyped `items: {}`.
Warnings
- —Response forecast array items are untyped in the OpenAPI schema (items: {}), so the exact structure of each forecast period is not formally documented.
- —The endpoint path uses a parameterized :id segment; callers must replace it with an ICAO or IATA airport code.
Citations
- —Price is $0.004 per requesthttps://stabletravel.dev/openapi.json
- —Endpoint returns airport_code, timeframe, forecast array, and raw_forecasthttps://stabletravel.dev/openapi.json
- —Optional parameters: timestamp, return_nearby_weather, temperature_units (fahrenheit or celsius)https://stabletravel.dev/openapi.json
- —Payment via USDC on Tempo (chainId 4217), MPP method=tempo, intent=chargehttps://stabletravel.dev/openapi.json
- —No API keys needed; payment serves as authenticationhttps://stabletravel.dev