polymerdao/polymer-pay-stabletravel-amadeus

StableTravel Amadeus

StableTravel provides pay-per-use access to flight search, hotel booking, activities, and airport transfers powered by Amadeus through x402 micropayments. No API keys, no subscriptions — pay per request.

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 (GET)

Search for flight offers using simple GET parameters. Best for one-way or round-trip searches.

Pricing: $0.05

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/stabletravel.dev/api/flights/search?originLocationCode=JFK&destinationLocationCode=LAX&departureDate=2025-06-15&adults=1&max=5",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Response: JSON with flight offers including airline, price, duration, and segments.

Flight Search (POST)

Advanced flight search with multi-city support and complex itineraries.

Pricing: $0.05

{
  "method": "POST",
  "url": "https://pay.polymerlabs.org/proxy/https/stabletravel.dev/api/flights/search",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "body": {
    "originDestinations": [
      {
        "id": "1",
        "originLocationCode": "JFK",
        "destinationLocationCode": "LAX",
        "departureDateTimeRange": { "date": "2025-06-15" }
      }
    ],
    "travelers": [{ "id": "1", "travelerType": "ADULT" }],
    "sources": ["GDS"],
    "searchCriteria": { "maxFlightOffers": 5 }
  }
}

Flight Price

Confirm pricing for a flight offer before booking.

Pricing: $0.03

{
  "method": "POST",
  "url": "https://pay.polymerlabs.org/proxy/https/stabletravel.dev/api/flights/price",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "body": {
    "data": {
      "type": "flight-offers-pricing",
      "flightOffers": [<flight-offer-object>]
    }
  }
}

Flight Book

Book a flight order after confirming price.

Pricing: $0.09

{
  "method": "POST",
  "url": "https://pay.polymerlabs.org/proxy/https/stabletravel.dev/api/flights/book",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "body": { /* flight order object */ }
}

Flight Status

Get real-time flight status by carrier and flight number.

Pricing: $0.005

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/stabletravel.dev/api/flights/status?carrierCode=AA&flightNumber=100&scheduledDepartureDate=2025-06-15",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Hotel List

List hotels by IATA city code.

Pricing: $0.03

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/stabletravel.dev/api/hotels/list?cityCode=PAR&max=10",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Hotel Search

Search hotel offers by hotel IDs (get IDs from /hotels/list first).

Pricing: $0.03

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/stabletravel.dev/api/hotels/search?hotelIds=RTLONMCI,RTLMADCI&checkInDate=2025-06-15&checkOutDate=2025-06-18&adults=2",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Hotel Book

Book a hotel offer.

Pricing: $0.002

{
  "method": "POST",
  "url": "https://pay.polymerlabs.org/proxy/https/stabletravel.dev/api/hotels/book",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "body": { /* hotel offer object */ }
}

Activities Search

Search tours and activities by latitude/longitude.

Pricing: $0.05

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/stabletravel.dev/api/activities/search?latitude=48.8566&longitude=2.3522&radius=5&max=10",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Transfers Search

Search airport transfer options.

Pricing: $0.003

{
  "method": "POST",
  "url": "https://pay.polymerlabs.org/proxy/https/stabletravel.dev/api/transfers/search",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "body": {
    "startLocationCode": "CDG",
    "endAddressLine": "Avenue des Champs-Elysees 1",
    "endCityName": "Paris",
    "endZipCode": "75008",
    "endCountryCode": "FR",
    "transferType": "PRIVATE",
    "startDateTime": "2025-06-15T10:00:00",
    "passengers": 2
  }
}

Reference Locations

Search for airports and cities by keyword.

Pricing: $0.005

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/stabletravel.dev/api/reference/locations?keyword=Paris&subType=AIRPORT,CITY",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

When to Use

• Flight booking — Search, price, and book flights
• Hotel booking — Find and book hotels
• Activities — Discover tours and activities at destinations
• Airport transfers — Book private or shared transfers
• Reference data — Look up airports, airlines, cities

Best Practices

• Search then price then book — Workflow: flight search → price confirm → book
• List hotels first — Get hotel IDs from /hotels/list before searching offers
• Use GET for simple searches — Use POST only for multi-city or complex itineraries
• Check flight status — Use /flights/status for real-time updates
• For real-time tracking — Use polymer-pay-stabletravel-flightaware for live flight positions
• For errors — See @skills/polymer-pay-api-errors/SKILL.md for complete error code reference and troubleshooting