Call GET /v1/analytics/itinerary-price-metrics with origin, destination, departureDate, and currencyCode
Parse the priceMetrics array to extract min, max, median, and first/third quartile fare levels
Compare the current Flight Offers Search result against the median to compute a percentile ranking
Surface the price assessment (BELOW_AVERAGE, AVERAGE, ABOVE_AVERAGE) to the user as a buy signal
Cache price metric results with a TTL appropriate to the route's volatility
Log the comparison for model calibration if building a price-prediction feature
Known gotchas
DECOMMISSIONED 2026-07-17: Amadeus shut down the Self-Service APIs portal — self-service API keys are disabled and the portal is inaccessible as of this date. These endpoints remain available only through an Amadeus Enterprise contract (Enterprise portal unaffected). Self-serve alternatives: Duffel, or an aggregator. Do not attempt self-service key registration; it was paused before shutdown.
Price Metrics are computed from historical booking data and lag real-time supply changes; they are directional indicators, not guarantees
The endpoint requires at least one week of historical data for the route; newly launched routes return a 204 with no metrics
Currency normalization is done at query time; comparing metrics denominated in different currencies requires explicit currencyCode alignment
Give your agent this knowledge — and 15,600+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?