jinko price-monitoring

Prices in this command’s output are integers in minor units. Money objects carry decimal_places — divide by 10 ** decimal_places to display ({ "value": 15977, "decimal_places": 2 } is 159.77, not 15,977). See Money & prices.

Watch a specific route and date pair over time so an agent can act when the fare drops. Use it for prompts like “alert me when Paris to New York for June 17 to 26 goes under €400”. Each response includes the current cheapest cached fare and an offer token you can pass to flight_search when the user decides to book. Cache-only; never triggers a live call.

Usage

jinko price-monitoring [options]

Options

Flag	Required	Description	Default
`--origin <code>`	Yes	origin IATA code (e.g. PAR for city, CDG for airport). JSON: `origin`.
`--destination <code>`	Yes	destination IATA code (e.g. NYC for city, JFK for airport). JSON: `destination`.
`--origin-type <type>`	No	origin code type: city or airport (default: city). JSON: `origin_type`.	`"city"`
`--destination-type <type>`	No	destination code type: city or airport (default: city). JSON: `destination_type`.	`"city"`
`--departure-date <date>`	Yes	departure date (YYYY-MM-DD). JSON: `departure_date`.
`--return-date <date>`	No	return date for round-trip (YYYY-MM-DD). JSON: `return_date`.
`--adults <n>`	No	number of adult passengers (default: 1). JSON: `adults`.
`--cabin-class <class>`	No	cabin class: economy, premium_economy, business, first. JSON: `cabin_class`.
`--direct-only`	No	only consider direct flights. JSON: `direct_only`.
`--max-price <amount>`	No	upper bound on total fare. JSON: `max_price`.
`--include-carriers <codes...>`	No	whitelist IATA 2-letter carrier codes (e.g. AF KL). JSON: `include_carriers`.
`--exclude-carriers <codes...>`	No	blacklist IATA 2-letter carrier codes (e.g. FR U2). JSON: `exclude_carriers`.
`--user-intent <text>`	No	the end user’s request in their own words, forwarded to Jinko for observability and relevance (avoid PII). Env fallback: JINKO_USER_INTENT. JSON: `intent.user_intent`.

Examples

# Plain poll for the cheapest cached PAR → NYC.
jinko price-monitoring --origin PAR --destination NYC \
  --departure-date 2026-06-17 --return-date 2026-06-26 --format json

# Cron entry: poll every 6 hours, alert on a hit.
# 0 */6 * * *
jinko price-monitoring --origin PAR --destination NYC \
    --departure-date 2026-06-17 --return-date 2026-06-26 \
    --direct-only --cabin-class economy --max-price 800 \
    --format json | jq -e '.status == "ok"' \
  && /usr/local/bin/notify-on-price-drop.sh

Introduction

Travel Demand

Flights

Hotels

Cart & Payment

Account & utilities

Usage

Options

Examples

​Usage

​Options

​Examples

Usage

Options

Examples