flight_price_advice accepts a flight with its current price. It compares that fare with
typical fares for comparable flights and provides price forecasts for the next 1 and 3 days,
including the forecasted price and estimated probabilities of an increase, decrease, or no change.
The tool does not search for a flight, fetch a live quote, monitor a fare, or book.
Input
Supply uppercase three-letter IATA city codes, a future departure date, trip and cabin classes, and one adult’s total fare including tax but excluding optional paid extras.current_price.value
is an integer in minor units, so { "value": 22840, "currency": "USD", "decimal_places": 2 }
means USD 228.40.
stops is the actual number of connections (0, 1, or 2). It is optional: omit it when the
number is unknown. Sending null is invalid. There is no max_stops or wait_days input because
the request describes an already selected flight and the response always includes both horizons.
unavailable result
when statistics do not cover them.
Output
The schema 3.2 response has four possible statuses:available, partial, unavailable, and
not_ready.
Each available forecast includes
forecasted_price and three estimated probabilities, ranging
from 0 to 1 and summing to 1. Changes within ±1% count as unchanged. When a forecast is
unavailable, forecasted_price is null and the response explains why. When neither assessment
is available, the response gives no booking recommendation.
Example price forecast
This example shows selected fields using prices and probabilities from an evaluation at2026-09-08T09:29:04Z for departure on 2026-09-26. The forecasted price after
3 days is USD 227.57, compared with the supplied fare of USD 228.40. These forecasts describe
prices estimated at that evaluation time.
horizon_days identifies how many days ahead the forecast applies. forecasted_price gives
the estimated fare at that horizon. A lower forecasted price can support waiting even when
an increase is the most likely direction. Use the structured fields for application logic and
the summary for display.