Best Move This Week
best_move_this_weekGiven the credit cards a user holds, rank this week's dollar-valued actions: which held card to use per spend category, welcome offers at a 12-month high on cards not held, active transfer bonuses, and (optionally) the savings-rate move beside the card move.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"wallet": "<wallet>"
},
"name": "best_move_this_week"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| wallet | Yes | Card ids the user holds, in the form issuer:slug, e.g. ["chase:sapphire-preferred", "amex:gold-card"]. | |
| categories | No | Optional spend categories to rank held cards for; defaults to all nine. | |
| usedBenefits | No | Optional log of period credits already used this month; excluded from picks and counted toward renewal value. Omit to treat every credit as unused. | |
| savingsBalance | No | Optional cash balance, to include the savings-rate move beside the card moves. | |
| currentSavingsApy | No | Optional current savings APY, used with savingsBalance. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| asOf | No | ISO timestamp of the underlying data this response reflects. | |
| tool | Yes | ||
| error | No | ||
| source | No | Where the data comes from (URL). | |
| toolMeta | No | Version and stability of the tool that produced this reply. See /developers#tool-versions. | |
| cardMoves | No | ||
| attribution | No | ||
| generatedAt | Yes | ISO timestamp this response was computed at. | |
| savingsMove | No | ||
| verified_at | No | ||
| unheldOffers | No | ||
| schemaVersion | Yes | ||
| methodologyUrl | No | ||
| freshnessStatus | No | ||
| transferBonuses | No |