Transfer partners

Transfer partner routes and ratios, point valuations, and running a transfer plan against a member's balances.

compare_transfer_options

What a balance of points is worth across transfer paths, with the arithmetic shown -- the points-quantity question, distinct from get_transfer_partners (which lists WHICH paths exist, not what YOUR points are worth). Call program only (from), target only (to), or both (one specific path, e.g. 60k UR → Hyatt).

Scope	Quota
`miles:read`	standard

Name	Type	Required
`points`	`integer`	required
`program`	`string`
`target`	`string`

get_transfer_partners

Transfer partner lookup. mode='from_program' lists where a currency (e.g. 'Chase Ultimate Rewards') transfers; 'to_program' lists which currencies reach a destination (e.g. 'World of Hyatt'); 'auto' infers.

Scope	Quota
`miles:read`	standard

Name	Type	Required
`query`	`string`	required
`mode`	`string`

get_valuations

Point valuations (cents per point) — the user's custom values when set, defaults otherwise.

Scope	Quota
`miles:read`	standard

Name	Type	Required
`programs`	`string[]`

plan_transfer

"I need N points at program X -- which of my HELD currencies gets me there cheapest?" The advisor flagship: ranks the loyalty currencies you've told Miles you hold (get_balances) by cheapest path to target_program -- transfer graph x ratios x active bonuses x transfer minimums/increments x your own valuations -- including two-currency split suggestions and "you hold it but not enough" rows. Deterministic, receipt-style, built on the same functions compare_transfer_options uses, so the two tools cannot disagree about a shared leg.

Scope	Quota
`miles:read`	standard

Name	Type	Required
`target_program`	`string`	required
`points_needed`	`integer`	required

portfolio_review

"Here are my balances -- where should I focus?" Ranks every loyalty currency the member has told Miles they hold against a redemption goal, and says which one to focus on, which to stop growing, and why.

Scope	Quota
`miles:read`	standard

Name	Type	Required
`goal`	`string`
`cardholder`	`string`

reset_valuation

Reset a custom valuation back to the Ask Miles default. Requires wallet-change access.

Scope	Quota
`miles:write`	standard

Name	Type	Required
`point_type`	`string`	required

set_valuation

Set the user's custom point/mile valuations (cents per point). Pass valuations to set several at once. Requires wallet-change access.

Scope	Quota
`miles:write`	standard

Name	Type	Required
`point_type`	`string`
`valuation`	`number`
`valuations`	`object`