transfer-partners

# Transfer Partner Optimizer Given award flight prices (from seats.aero or manual input) and your transferable point balances, find the cheapest path to book. **No API key needed.** Uses local JSON data files. ## Data Files | File | Purpose | |------|---------| | `data/transfer-partners.json` | Credit card → loyalty program transfer ratios | | `data/points-valuations.json` | CPP valuations per program (floor/ceiling from TPG, UP, OMAAT, VFTW) | | `data/partner-awards.json` | Which programs can book which airlines | ## When to Use - User has award availability (from seats.aero cached search, live search, or manual input) - User wants to know "which of my points should I use?" - User wants to compare the effective cost across their transferable currencies - User asks about transfer partners for a specific airline or program ## Workflow ### Step 0: Check Current Transfer Bonuses (Always) Before recommending any transfer, load the `transfer-bonuses` skill and check `data/transfer-bonuses.json` for active bonuses on the relevant currency-to-program pair. A 30% bonus turns a 1:1 ratio into 1:1.3, which can flip the cheapest-currency calculation in Step 3 entirely. Bonuses also have expiration dates that affect timing decisions. ### Step 1: Get Award Availability Use seats.aero (API or web) to search for award flights. Each result includes: - `Source` (the loyalty program: "united", "aeroplan", "flyingblue", etc.) - Points cost per cabin (e.g., 55,000 business) ### Step ...