polymerdao/polymer-pay-stabletravel-flightaware

FlightAware (StableTravel)

FlightAware provides real-time flight tracking, airport operations, flight history, and disruption statistics through the Polymer Pay proxy via StableTravel. Track flights, get positions, view historical data, and monitor airport operations.

Authentication

All requests route through the Polymer Pay proxy. Include your Polymer Pay API key in every request:

{
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Base URL: https://pay.polymerlabs.org/proxy/https/stabletravel.dev

Common Operations

Flight Search

Search flights by query string using FlightAware syntax (idents, latlong, airline).

Pricing: $0.10

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/stabletravel.dev/api/flightaware/flights/search?query=UAL123",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Response: JSON array of flights matching the query.

Flight by Ident

Get flights by flight number, registration, or callsign.

Pricing: $0.01

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/stabletravel.dev/api/flightaware/flights/UAL123",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Flight Position

Get latest position data for a specific flight.

Pricing: $0.02

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/stabletravel.dev/api/flightaware/flights/{id}/position",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Flight Track

Get full position history/track for a flight.

Pricing: $0.024

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/stabletravel.dev/api/flightaware/flights/{id}/track",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Flight Map

Get flight track as a PNG map image.

Pricing: $0.06

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/stabletravel.dev/api/flightaware/flights/{id}/map",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Airport Info

Get information about a specific airport by code.

Pricing: $0.03

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/stabletravel.dev/api/flightaware/airports/JFK",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Airport Delays

Get delay information for a specific airport.

Pricing: $0.02

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/stabletravel.dev/api/flightaware/airports/JFK/delays",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Airport Flights

Get flights at an airport (arrivals, departures, enroute).

Pricing: $0.04

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/stabletravel.dev/api/flightaware/airports/JFK/flights",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Airport Weather (METAR)

Get current weather observations for an airport.

Pricing: $0.004

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/stabletravel.dev/api/flightaware/airports/JFK/weather/observations",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Historical Flight

Get historical flight data by ident.

Pricing: $0.04

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/stabletravel.dev/api/flightaware/history/flights/UAL123",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Historical Track

Get historical flight track.

Pricing: $0.12

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/stabletravel.dev/api/flightaware/history/flights/{id}/track",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Disruption Counts

Get disruption statistics for airlines or airports.

Pricing: $0.01

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/stabletravel.dev/api/flightaware/disruption-counts/airline/UAL",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

When to Use

• Real-time tracking — Monitor live flights with position updates
• Flight status — Get current flight information and status
• Airport operations — View arrivals, departures, delays at airports
• Historical data — Research past flights and routes
• Disruption monitoring — Track delays and disruptions for airlines/airports
• Weather — Get METAR and TAF weather for airports

Best Practices

• Use ident first — Start with /flights/{ident} to get the fa_flight_id
• Track with ID — Use the fa_flight_id for position/track queries
• Check airport status — Use /airports/{id} + /delays + /weather/observations
• Compare with Amadeus — Use polymer-pay-stabletravel-amadeus for booking; FlightAware for tracking
• For errors — See @skills/polymer-pay-api-errors/SKILL.md for complete error code reference and troubleshooting