Flight price advice (preview)

Use this preview to compare a supplied fare with typical fares for comparable flights and receive fixed 1-day and 3-day price forecasts. Each available forecast includes a forecasted price and estimated probabilities that the price will increase, decrease, or remain unchanged. Contact support to request access. Initial numeric coverage is one-adult, one-way, nonstop, USD; other valid inputs return a reasoned unavailable result.

Tool description (what the LLM sees)

This tool is in preview. Contact support to request access. It accepts a flight with its current price and returns schema 3.2 price advice when data covers the request.

The response contains fixed 1-day and 3-day price forecasts; the user does not select a wait duration. Each available forecast includes a forecasted price and estimated probabilities that the price will increase, decrease, or remain unchanged relative to current_price. price_assessment compares the supplied fare with typical prices for comparable flights. recommendation.summary is deterministic and can be displayed without an LLM.

The current_price is the one-adult total including tax and excluding optional paid extras. Its value is an integer in minor units: {value:32000,currency:"USD",decimal_places:2} means USD 320.00. Initial numeric coverage is one-way, nonstop, USD. Other structurally valid currencies, trip types, and stop counts are accepted and return an unavailable reason when statistics do not cover them. Omit stops when the actual number of connections is unknown. This tool does not search, monitor, quote, or book flights.

Parameters

Name	Type	Required	Description
`origin`	`string`	Yes	Uppercase three-letter IATA city code for the flight’s origin. Airport codes are not mapped to cities.
`destination`	`string`	Yes	Uppercase three-letter IATA city code for the flight’s destination; it must differ from origin. Airport codes are not mapped to cities.
`departure_date`	`string`	Yes	Departure date in YYYY-MM-DD format; it must be a real calendar date strictly after the current UTC date.
`trip_type`	`enum ("oneway" \| "roundtrip")`	Yes	Trip shape. The preview accepts oneway and roundtrip; planned initial statistics cover oneway only.
`stops`	`enum (0 \| 1 \| 2)`	No	Actual number of flight connections: 0 for nonstop, 1, or 2. Omit when unknown.
`cabin_class`	`enum ("economy" \| "premium_economy" \| "business" \| "first")`	Yes	Cabin class: economy, premium_economy, business, or first.
`current_price`	`object`	Yes	One adult’s total fare including tax for the supplied trip, excluding optional paid extras.
`current_price.value`	`integer`	Yes	One adult total fare as a positive safe integer in minor units.
`current_price.currency`	`string`	Yes	Supported uppercase ISO 4217 currency code.
`current_price.decimal_places`	`integer`	Yes	Currency minor-unit precision; it must match the currency’s ISO 4217 value.
`user_intent`	`string`	No	The end user’s current request in their own words, e.g. “help me with my travel plans”. Pass it as-is when short; otherwise condense the goal and constraints into 1-2 sentences. Strip personal identifiers (names, emails, phone numbers, addresses, payment details), replace them with placeholders like “[name]”. Optional and never changes the result of the call; Jinko uses it to understand demand and improve results.

Introduction

Flights

Hotels

Cars

Cart & Payment

Flight price advice (preview)

Parameters

​Parameters

Parameters