Flight price advice (preview)

Use this preview to validate the flight and current price input before statistics are available. It returns fixed 1-day and 3-day horizons; the user does not select a wait duration. Each horizon reports the probabilities that the price will increase, decrease, or stay unchanged relative to current_price; all three are null while the preview is not ready. Contact support to request access. It returns no assessment, evidence, alert, booking action, or live quote.

Tool description (what the LLM sees)

This tool is in preview. Contact support to request access. It accepts a flight with its current price, validates the request, and returns status "not_ready" while statistics are unavailable.

The response contains fixed 1-day and 3-day horizons; the user does not select a wait duration. The current_price is the total fare for one adult for the supplied trip, 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. This is an encoding example only, not a computed statistic.

This tool does not search flights, load statistics, create monitoring, make a buy/wait recommendation, or book anything. Structural trip_type, max_stops, and cabin_class values are accepted for contract validation; the future initial statistics are expected to cover one-way nonstop requests only, and this preview does not imply route coverage.

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.
`max_stops`	`enum (0 \| 1 \| 2)`	Yes	Maximum number of stops: 0, 1, or 2. Planned initial statistics cover nonstop flights only.
`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