earnrate 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (109) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +216 -2
  3. package/data/CHANGELOG.md +210 -0
  4. package/data/LICENSE +412 -0
  5. package/data/VERSION +1 -0
  6. package/data/cards/amex-blue-business-plus.yaml +62 -0
  7. package/data/cards/amex-blue-cash-everyday.yaml +88 -0
  8. package/data/cards/amex-blue-cash-preferred.yaml +76 -0
  9. package/data/cards/amex-gold.yaml +94 -0
  10. package/data/cards/amex-platinum.yaml +71 -0
  11. package/data/cards/bank-of-america-atmos-rewards-ascent.yaml +71 -0
  12. package/data/cards/bank-of-america-atmos-rewards-business.yaml +72 -0
  13. package/data/cards/bank-of-america-atmos-rewards-summit.yaml +70 -0
  14. package/data/cards/bilt-obsidian.yaml +91 -0
  15. package/data/cards/capital-one-kohls-card.yaml +33 -0
  16. package/data/cards/capital-one-kohls-rewards-visa.yaml +48 -0
  17. package/data/cards/capital-one-savor.yaml +89 -0
  18. package/data/cards/capital-one-venture-x.yaml +58 -0
  19. package/data/cards/capital-one-venture.yaml +57 -0
  20. package/data/cards/chase-aeroplan.yaml +101 -0
  21. package/data/cards/chase-freedom-flex.yaml +146 -0
  22. package/data/cards/chase-freedom-unlimited.yaml +69 -0
  23. package/data/cards/chase-ihg-one-rewards-business.yaml +77 -0
  24. package/data/cards/chase-ihg-one-rewards-premier-select.yaml +44 -0
  25. package/data/cards/chase-ihg-one-rewards-premier.yaml +68 -0
  26. package/data/cards/chase-ihg-one-rewards.yaml +62 -0
  27. package/data/cards/chase-ink-business-cash.yaml +97 -0
  28. package/data/cards/chase-ink-business-preferred.yaml +93 -0
  29. package/data/cards/chase-prime-visa.yaml +103 -0
  30. package/data/cards/chase-sapphire-preferred.yaml +91 -0
  31. package/data/cards/chase-sapphire-reserve.yaml +86 -0
  32. package/data/cards/chase-southwest-performance-business.yaml +81 -0
  33. package/data/cards/chase-southwest-plus.yaml +72 -0
  34. package/data/cards/chase-southwest-premier-business.yaml +69 -0
  35. package/data/cards/chase-southwest-premier.yaml +72 -0
  36. package/data/cards/chase-southwest-priority.yaml +58 -0
  37. package/data/cards/chase-united-business.yaml +82 -0
  38. package/data/cards/chase-united-club-business.yaml +54 -0
  39. package/data/cards/chase-united-club.yaml +74 -0
  40. package/data/cards/chase-united-explorer.yaml +68 -0
  41. package/data/cards/chase-united-gateway.yaml +64 -0
  42. package/data/cards/chase-united-quest.yaml +85 -0
  43. package/data/cards/citi-aadvantage-business.yaml +78 -0
  44. package/data/cards/citi-aadvantage-executive.yaml +63 -0
  45. package/data/cards/citi-aadvantage-globe.yaml +65 -0
  46. package/data/cards/citi-aadvantage-mileup.yaml +57 -0
  47. package/data/cards/citi-aadvantage-platinum-select.yaml +68 -0
  48. package/data/cards/citi-costco-anywhere-visa-business.yaml +87 -0
  49. package/data/cards/citi-costco-anywhere-visa.yaml +86 -0
  50. package/data/cards/citi-custom-cash.yaml +124 -0
  51. package/data/cards/citi-double-cash.yaml +68 -0
  52. package/data/cards/citi-my-best-buy-visa.yaml +49 -0
  53. package/data/cards/citi-strata-elite.yaml +70 -0
  54. package/data/cards/citi-strata-premier.yaml +89 -0
  55. package/data/cards/sofi-unlimited-2.yaml +29 -0
  56. package/data/cards/td-bank-nordstrom-credit-card.yaml +69 -0
  57. package/data/cards/td-bank-nordstrom-visa.yaml +105 -0
  58. package/data/cards/td-bank-target-circle-card.yaml +51 -0
  59. package/data/cards/usbank-cash-plus.yaml +102 -0
  60. package/data/cards/wells-fargo-active-cash.yaml +34 -0
  61. package/data/cards/wells-fargo-autograph.yaml +82 -0
  62. package/data/categories.yaml +121 -0
  63. package/data/currencies.yaml +145 -0
  64. package/data/merchants/overrides.yaml +247 -0
  65. package/data/merchants/seed.yaml +478 -0
  66. package/dist/brand.js +11 -0
  67. package/dist/cli/args.js +113 -0
  68. package/dist/cli/bin.js +17 -0
  69. package/dist/cli/format.js +86 -0
  70. package/dist/cli/import.js +260 -0
  71. package/dist/cli/offers.js +127 -0
  72. package/dist/cli/run.js +153 -0
  73. package/dist/data/integrity.js +229 -0
  74. package/dist/data/load.js +47 -0
  75. package/dist/data/wallet-write.js +140 -0
  76. package/dist/engine/bonus.js +66 -0
  77. package/dist/engine/evaluate.js +156 -0
  78. package/dist/engine/offers.js +67 -0
  79. package/dist/engine/periods.js +31 -0
  80. package/dist/engine/profiles.js +13 -0
  81. package/dist/engine/recommend.js +416 -0
  82. package/dist/engine/record.js +55 -0
  83. package/dist/engine/types.js +1 -0
  84. package/dist/engine/valuation.js +35 -0
  85. package/dist/engine/wallet-summary.js +70 -0
  86. package/dist/import/amex.js +73 -0
  87. package/dist/import/analyze.js +207 -0
  88. package/dist/import/chase.js +55 -0
  89. package/dist/import/csv.js +55 -0
  90. package/dist/import/statement.js +23 -0
  91. package/dist/mcp/bin.js +3 -0
  92. package/dist/mcp/schemas.js +174 -0
  93. package/dist/mcp/serve.js +29 -0
  94. package/dist/mcp/server.js +308 -0
  95. package/dist/merchants/anthropic.js +87 -0
  96. package/dist/merchants/cache.js +91 -0
  97. package/dist/merchants/classifier.js +1 -0
  98. package/dist/merchants/fallback.js +96 -0
  99. package/dist/merchants/from-env.js +36 -0
  100. package/dist/merchants/resolve.js +132 -0
  101. package/dist/schema/card.js +136 -0
  102. package/dist/schema/category.js +11 -0
  103. package/dist/schema/common.js +25 -0
  104. package/dist/schema/currency.js +15 -0
  105. package/dist/schema/merchant.js +32 -0
  106. package/dist/schema/wallet.js +49 -0
  107. package/dist/version.js +5 -0
  108. package/package.json +72 -4
  109. package/wallet.example.yaml +32 -0
@@ -0,0 +1,58 @@
1
+ id: capital-one-venture-x
2
+ name: Capital One Venture X Rewards Credit Card
3
+ issuer: capitalone
4
+ network: visa # Visa Infinite, per the card page's footnotes
5
+ currency: C1
6
+ last_verified: 2026-10-26
7
+ verified_by: collin
8
+ source_urls:
9
+ - https://www.capitalone.com/credit-cards/venture-x/
10
+ base_rate: 2
11
+ annual_fee: 395
12
+ welcome_offer:
13
+ points: 75000
14
+ spend: 4000
15
+ months: 3
16
+ note: One-time bonus through the card page's Apply Now button; it may not be available after leaving the page. Existing or previous cardmembers are not eligible if they received a new cardmember bonus for this product in the past 48 months. The 10,000-mile anniversary bonus is separate and not part of this offer.
17
+ rules:
18
+ - id: capital-one-travel-hotels-and-car-rentals
19
+ match:
20
+ { merchants: [capital-one-travel-hotels, capital-one-travel-car-rentals] }
21
+ rate: 10
22
+ note: Only when booked through Capital One Travel. Purchases paid with the annual $300 Capital One Travel credit earn no miles.
23
+ - id: capital-one-travel-flights-and-vacation-rentals
24
+ match:
25
+ {
26
+ merchants:
27
+ [capital-one-travel-flights, capital-one-travel-vacation-rentals],
28
+ }
29
+ rate: 5
30
+ note: Only when booked through Capital One Travel.
31
+ - id: capital-one-entertainment
32
+ match: { merchants: [capital-one-entertainment] }
33
+ rate: 5
34
+ note: Tickets bought on the Capital One Entertainment ticketing platform only. Cardholder-exclusive pre-sales and tickets bought directly from Capital One Hall or Capital One Arena are excluded.
35
+ # Not modeled on purpose: the $300 annual Capital One Travel credit, the
36
+ # 10,000-mile anniversary bonus and the $120 Global Entry/TSA PreCheck credit.
37
+ todo:
38
+ - The card page doesn't say whether Premier Collection and Lifestyle Collection hotel bookings earn the 10X Capital One Travel rate. Modeled as regular Capital One Travel hotels.
39
+ # Issuer text backing each rule; `yarn check-sources` checks it weekly.
40
+ evidence:
41
+ - rule: base_rate
42
+ url: https://www.capitalone.com/credit-cards/venture-x/
43
+ quote: '2X Miles on all other purchases, every day'
44
+ - rule: capital-one-travel-hotels-and-car-rentals
45
+ url: https://www.capitalone.com/credit-cards/venture-x/
46
+ quote: '10X Miles on hotels & rental cars booked through Capital One Travel'
47
+ - rule: capital-one-travel-flights-and-vacation-rentals
48
+ url: https://www.capitalone.com/credit-cards/venture-x/
49
+ quote: '5X Miles on flights and vacation rentals booked through Capital One Travel'
50
+ - rule: capital-one-entertainment
51
+ url: https://www.capitalone.com/credit-cards/venture-x/
52
+ quote: 'Plus earn 5X miles on Capital One Entertainment purchases'
53
+ - rule: annual_fee
54
+ url: https://www.capitalone.com/credit-cards/venture-x/
55
+ quote: 'ANNUAL FEE $395'
56
+ - rule: welcome_offer
57
+ url: https://www.capitalone.com/credit-cards/venture-x/
58
+ quote: 'Earn 75,000 bonus miles once you spend $4,000 on purchases within the first 3 months from account opening'
@@ -0,0 +1,57 @@
1
+ id: capital-one-venture
2
+ name: Capital One Venture Rewards Credit Card
3
+ issuer: capitalone
4
+ # The card page never names the network in visible text. Its embedded product
5
+ # data says MasterCard; older Venture accounts may be on Visa.
6
+ network: mastercard
7
+ currency: C1
8
+ last_verified: 2026-10-26
9
+ verified_by: collin
10
+ source_urls:
11
+ - https://www.capitalone.com/credit-cards/venture/
12
+ base_rate: 2
13
+ annual_fee: 95
14
+ welcome_offer:
15
+ points: 75000
16
+ spend: 4000
17
+ months: 3
18
+ note: Labeled a limited-time offer, with no end date stated. Comes with a one-time $300 Capital One Travel Stays credit for hotel and vacation rental bookings through Capital One Travel, expiring one year after account opening. Available by applying through the card page. Not available to anyone who received a new cardmember bonus for the Venture or Venture X in the past 48 months.
19
+ rules:
20
+ - id: capital-one-travel-hotels-vacation-rentals-car-rentals
21
+ match:
22
+ {
23
+ merchants:
24
+ [
25
+ capital-one-travel-hotels,
26
+ capital-one-travel-vacation-rentals,
27
+ capital-one-travel-car-rentals,
28
+ ],
29
+ }
30
+ rate: 5
31
+ note: Only when booked through Capital One Travel. Flights booked there earn the base 2X.
32
+ - id: capital-one-entertainment
33
+ match: { merchants: [capital-one-entertainment] }
34
+ rate: 5
35
+ note: Tickets bought on the Capital One Entertainment ticketing platform only. Tickets bought directly from Capital One Hall or Capital One Arena are excluded.
36
+ # Not modeled on purpose: the first-year $300 Capital One Travel Stays credit
37
+ # and the $120 Global Entry/TSA PreCheck credit.
38
+ todo:
39
+ - Network isn't shown in the card page's visible text. Set to mastercard from the page's embedded product data (cardNetwork MasterCard); confirm against a current card or the Rates & Fees disclosure.
40
+ - Capital One's transfer-partners article (capitalone.com/learn-grow/money-management/venture-miles-transfer-partnerships/) says Venture earns 5X on "activities" through Capital One Travel too. The card page doesn't, so activities aren't modeled.
41
+ # Issuer text backing each rule; `yarn check-sources` checks it weekly.
42
+ evidence:
43
+ - rule: base_rate
44
+ url: https://www.capitalone.com/credit-cards/venture/
45
+ quote: 'Earn unlimited 2X miles per dollar on every purchase, every day.'
46
+ - rule: capital-one-travel-hotels-vacation-rentals-car-rentals
47
+ url: https://www.capitalone.com/credit-cards/venture/
48
+ quote: 'Earn 5X miles on hotels, vacation rentals and rental cars booked through Capital One Travel.'
49
+ - rule: capital-one-entertainment
50
+ url: https://www.capitalone.com/credit-cards/venture/
51
+ quote: 'Eligible cardholders will earn 5 miles per dollar spent on Capital One Entertainment purchases.'
52
+ - rule: annual_fee
53
+ url: https://www.capitalone.com/credit-cards/venture/
54
+ quote: 'ANNUAL FEE $95 PURCHASE RATE'
55
+ - rule: welcome_offer
56
+ url: https://www.capitalone.com/credit-cards/venture/
57
+ quote: 'plus earn 75,000 bonus miles once you spend $4,000 on purchases within the first 3 months'
@@ -0,0 +1,101 @@
1
+ id: chase-aeroplan
2
+ name: Chase Air Canada Aeroplan Card
3
+ issuer: chase
4
+ network: mastercard
5
+ currency: aeroplan
6
+ last_verified: 2026-10-26
7
+ verified_by: collin
8
+ source_urls:
9
+ - https://creditcards.chase.com/travel-credit-cards/aircanada/aeroplan
10
+ - https://www.chase.com/personal/credit-cards/rewards-category-faq
11
+ base_rate: 1
12
+ annual_fee: 195
13
+ welcome_offer:
14
+ points: 75000
15
+ spend: 4000
16
+ months: 3
17
+ note: 'Up to 115,000 points: plus 40,000 more after $20,000 in purchases in the first 12 months. Billed as "our best offer ever", with the usual 60,000 struck through; no end date given. Chase: "available to you if you do not have the Chase Air Canada Aeroplan Card or previous versions and have not received a new cardmember bonus for the Chase Air Canada Aeroplan Card or previous versions in the past 24 months."'
18
+ rules:
19
+ - id: air-canada
20
+ match: { merchants: [air-canada] }
21
+ rate: 3
22
+ note: The card's own rate. The "up to 5X" Chase advertises adds 2X that Air Canada awards on eligible flights to Aeroplan 25K members, which isn't card earning. Gift cards, onboard Wi-Fi, and hotels, car rentals and other partner products sold on aircanada.com are excluded.
23
+ - id: travel
24
+ match: { categories: [travel] }
25
+ rate: 3
26
+ note: In-flight purchases, merchants inside hotels and airports, and sellers of points or miles are excluded from Chase's travel category.
27
+ - id: transit-as-travel
28
+ match: { categories: [transit] }
29
+ rate: 3
30
+ note: Chase's travel category includes passenger trains, buses, taxis, ferries, tolls and parking. Rideshare codes as a taxi.
31
+ - id: grocery-2026
32
+ match: { categories: [grocery] }
33
+ exclude: { merchants: [walmart, target] }
34
+ rate: 3
35
+ valid_to: 2026-12-31
36
+ note: 3X applies to purchases that post by December 31, 2026. Chase's grocery category excludes warehouse clubs, discount stores such as Walmart and Target, and gas at grocery stores.
37
+ - id: grocery
38
+ match: { categories: [grocery] }
39
+ exclude: { merchants: [walmart, target] }
40
+ rate: 2
41
+ valid_from: 2027-01-01
42
+ note: Chase's grocery category excludes warehouse clubs, discount stores such as Walmart and Target, and gas at grocery stores.
43
+ - id: dining-2026
44
+ match: { categories: [dining] }
45
+ rate: 3
46
+ valid_to: 2026-12-31
47
+ note: 3X applies to purchases that post by December 31, 2026. Includes takeout and eligible delivery services.
48
+ - id: dining
49
+ match: { categories: [dining] }
50
+ rate: 2
51
+ valid_from: 2027-01-01
52
+ note: Includes takeout and eligible delivery services.
53
+ - id: gas
54
+ match: { categories: [gas] }
55
+ rate: 2
56
+ todo:
57
+ - 'Through December 31, 2026, the cardmember page creditcards.chase.com/aircanada lists 500 bonus points for each $2,000 spent per calendar month, up to 1,500 a month (+0.25x on the first $6,000). It is not on the product page, and the engine picks one rule rather than stacking, so it is not modeled.'
58
+ # Issuer text backing each rule; `yarn check-sources` checks it weekly.
59
+ evidence:
60
+ - rule: base_rate
61
+ url: https://creditcards.chase.com/travel-credit-cards/aircanada/aeroplan
62
+ quote: '1X points per $1 spent on all other purchases.'
63
+ - rule: air-canada
64
+ url: https://creditcards.chase.com/travel-credit-cards/aircanada/aeroplan
65
+ quote: 'You’ll earn 3 points for each $1 spent on purchases made with Air Canada® directly.'
66
+ - rule: air-canada
67
+ url: https://creditcards.chase.com/travel-credit-cards/aircanada/aeroplan
68
+ quote: 'plus an additional 2X points from Air Canada when traveling as an Aeroplan 25K member'
69
+ - rule: travel
70
+ url: https://creditcards.chase.com/travel-credit-cards/aircanada/aeroplan
71
+ quote: '3X points per $1 spent on travel purchases.'
72
+ - rule: transit-as-travel
73
+ url: https://www.chase.com/personal/credit-cards/rewards-category-faq
74
+ quote: 'discount travel sites, campgrounds and operators of passenger trains, buses, taxis, limousines, ferries'
75
+ - rule: grocery-2026
76
+ url: https://creditcards.chase.com/travel-credit-cards/aircanada/aeroplan
77
+ quote: 'Grocery store and dining rewards category purchases that post to your account by December 31, 2026'
78
+ - rule: grocery-2026
79
+ url: https://creditcards.chase.com/travel-credit-cards/aircanada/aeroplan
80
+ quote: 'Through December 31, 2026, these purchases will earn 3X points per $1 spent.'
81
+ - rule: grocery
82
+ url: https://creditcards.chase.com/travel-credit-cards/aircanada/aeroplan
83
+ quote: '2X points per $1 spent at grocery stores.'
84
+ - rule: grocery
85
+ url: https://www.chase.com/personal/credit-cards/rewards-category-faq
86
+ quote: 'such as warehouse clubs, discount stores and some smaller merchants such as drugstores'
87
+ - rule: dining-2026
88
+ url: https://creditcards.chase.com/travel-credit-cards/aircanada/aeroplan
89
+ quote: 'Grocery store and dining rewards category purchases that post to your account by December 31, 2026'
90
+ - rule: dining
91
+ url: https://creditcards.chase.com/travel-credit-cards/aircanada/aeroplan
92
+ quote: '2X points per $1 spent on dining, including takeout and eligible delivery services.'
93
+ - rule: gas
94
+ url: https://creditcards.chase.com/travel-credit-cards/aircanada/aeroplan
95
+ quote: '2X points per $1 spent at gas stations.'
96
+ - rule: annual_fee
97
+ url: https://creditcards.chase.com/travel-credit-cards/aircanada/aeroplan
98
+ quote: 'ANNUAL FEE $195'
99
+ - rule: welcome_offer
100
+ url: https://creditcards.chase.com/travel-credit-cards/aircanada/aeroplan
101
+ quote: 'Earn 75,000 bonus points after you spend $4,000 on purchases in the first 3 months your account is open'
@@ -0,0 +1,146 @@
1
+ id: chase-freedom-flex
2
+ name: Chase Freedom Flex
3
+ issuer: chase
4
+ network: mastercard
5
+ currency: cash
6
+ last_verified: 2026-10-26
7
+ verified_by: collin
8
+ source_urls:
9
+ - https://creditcards.chase.com/cash-back-credit-cards/freedom/flex
10
+ - https://www.chase.com/personal/credit-cards/education/rewards-benefits/how-to-combine-chase-credit-card-points-in-household
11
+ - https://www.chase.com/personal/credit-cards/rewards-category-faq
12
+ base_rate: 1
13
+ annual_fee: 0
14
+ welcome_offer:
15
+ dollars: 250
16
+ spend: 500
17
+ months: 3
18
+ note: 'Limited-time: the page says "Offer ending soon" (no end date given) and shows the usual $200 struck through. Chase: "available to you if you do not have this card and have not received a new cardmember bonus for this card in the past 24 months."'
19
+ # Its cash back is earned as points, which Chase lets you move to another
20
+ # Ultimate Rewards card on your account.
21
+ pools_into:
22
+ currency: UR
23
+ when_wallet_has:
24
+ [
25
+ chase-sapphire-preferred,
26
+ chase-sapphire-reserve,
27
+ chase-ink-business-preferred,
28
+ ]
29
+ caps:
30
+ - id: five-percent-quarterly
31
+ amount: 1500
32
+ period: quarter
33
+ then_rate: 1
34
+ rules:
35
+ - id: chase-travel
36
+ match: { merchants: [chase-travel] }
37
+ rate: 5
38
+ - id: dining
39
+ match: { categories: [dining] }
40
+ rate: 3
41
+ note: Includes takeout and eligible delivery services.
42
+ - id: drugstores
43
+ match: { categories: [drugstore] }
44
+ rate: 3
45
+ - id: lyft
46
+ match: { merchants: [lyft] }
47
+ rate: 2
48
+ valid_to: 2027-09-30
49
+ note: Limited-time offer, for Lyft products bought in the Lyft app.
50
+ # Rotating 5% categories. Activation is per quarter; activating after the
51
+ # quarter starts still applies to the whole quarter.
52
+ - id: q4-2026-grocery
53
+ match: { categories: [grocery] }
54
+ exclude: { merchants: [walmart, target] }
55
+ rate: 5
56
+ cap: five-percent-quarterly
57
+ requires: { activation: true }
58
+ valid_from: 2026-10-01
59
+ valid_to: 2026-12-31
60
+ note: Grocery stores excluding Walmart and Target. Chase's grocery category also excludes warehouse clubs, discount stores and gas at grocery stores; delivery services count only if they code as a grocery store.
61
+ - id: q4-2026-dining
62
+ match: { categories: [dining] }
63
+ rate: 5
64
+ cap: five-percent-quarterly
65
+ requires: { activation: true }
66
+ valid_from: 2026-10-01
67
+ valid_to: 2026-12-31
68
+ note: Dining already earns 3%, so this adds 2% until the $1,500 quarterly cap.
69
+ - id: q4-2026-american-red-cross
70
+ match: { merchants: [american-red-cross] }
71
+ rate: 5
72
+ cap: five-percent-quarterly
73
+ requires: { activation: true }
74
+ valid_from: 2026-10-01
75
+ valid_to: 2026-12-31
76
+ - id: q1-2027-grocery
77
+ match: { categories: [grocery] }
78
+ exclude: { merchants: [walmart, target] }
79
+ rate: 5
80
+ cap: five-percent-quarterly
81
+ requires: { activation: true }
82
+ valid_from: 2027-01-01
83
+ valid_to: 2027-03-31
84
+ note: Grocery stores excluding Walmart and Target. Activation opens December 15, 2026.
85
+ - id: q1-2027-streaming
86
+ match: { categories: [streaming] }
87
+ rate: 5
88
+ cap: five-percent-quarterly
89
+ requires: { activation: true }
90
+ valid_from: 2027-01-01
91
+ valid_to: 2027-03-31
92
+ note: Only the "top streaming services" Chase lists at chase.com/RewardsCategoryFAQs. Activation opens December 15, 2026.
93
+ # Issuer text backing each rule; `yarn check-sources` checks it weekly.
94
+ evidence:
95
+ - rule: base_rate
96
+ url: https://creditcards.chase.com/cash-back-credit-cards/freedom/flex
97
+ quote: 'Earn 1% on all other purchases'
98
+ - rule: chase-travel
99
+ url: https://creditcards.chase.com/cash-back-credit-cards/freedom/flex
100
+ quote: 'Earn 5% on travel purchased through Chase Travel'
101
+ - rule: dining
102
+ url: https://creditcards.chase.com/cash-back-credit-cards/freedom/flex
103
+ quote: 'Earn 3% on dining at restaurants, including takeout and eligible delivery services'
104
+ - rule: drugstores
105
+ url: https://creditcards.chase.com/cash-back-credit-cards/freedom/flex
106
+ quote: 'Earn 3% on drugstore purchases'
107
+ - rule: lyft
108
+ url: https://creditcards.chase.com/cash-back-credit-cards/freedom/flex
109
+ quote: 'Earn 2% total cash back on Lyft rides with your Freedom Flex card through September 30, 2027'
110
+ - rule: q4-2026-grocery
111
+ url: https://creditcards.chase.com/cash-back-credit-cards/freedom/flex
112
+ quote: 'CURRENT QUARTER Grocery Stores'
113
+ - rule: q4-2026-grocery
114
+ url: https://creditcards.chase.com/cash-back-credit-cards/freedom/flex
115
+ quote: 'Activate each quarter to earn 5% cash back on up to $1,500 in combined purchases'
116
+ - rule: q4-2026-grocery
117
+ url: https://www.chase.com/personal/credit-cards/rewards-category-faq
118
+ quote: 'Purchases made at gas stations from merchants who also operate grocery stores are not included'
119
+ - rule: q4-2026-dining
120
+ url: https://creditcards.chase.com/cash-back-credit-cards/freedom/flex
121
+ quote: 'Dining American Red Cross'
122
+ - rule: q4-2026-american-red-cross
123
+ url: https://creditcards.chase.com/cash-back-credit-cards/freedom/flex
124
+ quote: 'American Red Cross'
125
+ - rule: q1-2027-grocery
126
+ url: https://creditcards.chase.com/cash-back-credit-cards/freedom/flex
127
+ quote: 'NEXT QUARTER Grocery Stores'
128
+ - rule: q1-2027-streaming
129
+ url: https://creditcards.chase.com/cash-back-credit-cards/freedom/flex
130
+ quote: 'Top Streaming Services'
131
+ - rule: q1-2027-streaming
132
+ url: https://www.chase.com/personal/credit-cards/rewards-category-faq
133
+ quote: 'Only subscriptions paid for, or purchases made with the following select merchants will qualify'
134
+ - rule: pools_into
135
+ url: https://www.chase.com/personal/credit-cards/education/rewards-benefits/how-to-combine-chase-credit-card-points-in-household
136
+ quote: 'You can combine points from one Chase card to another Chase card on your account'
137
+ - rule: annual_fee
138
+ url: https://creditcards.chase.com/cash-back-credit-cards/freedom/flex
139
+ quote: 'ANNUAL FEE $0'
140
+ - rule: welcome_offer
141
+ url: https://creditcards.chase.com/cash-back-credit-cards/freedom/flex
142
+ quote: 'Earn a $250 bonus after you spend $500 on purchases in the first 3 months from account opening'
143
+ todo:
144
+ - "Chase's offer-details overlays for the Q4 2026 and Q1 2027 categories (exact grocery exclusions, what counts for American Red Cross) didn't render in the page dump; rules follow the calendar labels and the rewards-category FAQ."
145
+ - 'q4-2026-american-red-cross: what counts (presumably donations) is unconfirmed.'
146
+ - 'Q2 2027 (Apr-Jun) shows "Coming Soon"; add it after Chase posts it (activation opens March 15, 2027).'
@@ -0,0 +1,69 @@
1
+ id: chase-freedom-unlimited
2
+ name: Chase Freedom Unlimited
3
+ issuer: chase
4
+ network: visa
5
+ currency: cash
6
+ last_verified: 2026-10-24
7
+ verified_by: collin
8
+ source_urls:
9
+ - https://creditcards.chase.com/cash-back-credit-cards/freedom/unlimited
10
+ - https://www.chase.com/personal/credit-cards/education/rewards-benefits/how-to-combine-chase-credit-card-points-in-household
11
+ base_rate: 1.5
12
+ annual_fee: 0
13
+ welcome_offer:
14
+ dollars: 200
15
+ spend: 500
16
+ months: 3
17
+ note: 'Paid as 20,000 Ultimate Rewards points. Chase: "available to you if you do not have this card and have not received a new cardmember bonus for this card in the past 24 months."'
18
+ # Its cash back is earned as points, which Chase lets you move to another
19
+ # Ultimate Rewards card on your account, where they transfer like any other UR.
20
+ pools_into:
21
+ currency: UR
22
+ when_wallet_has:
23
+ [
24
+ chase-sapphire-preferred,
25
+ chase-sapphire-reserve,
26
+ chase-ink-business-preferred,
27
+ ]
28
+ rules:
29
+ - id: chase-travel
30
+ match: { merchants: [chase-travel] }
31
+ rate: 5
32
+ - id: dining
33
+ match: { categories: [dining] }
34
+ rate: 3
35
+ note: Includes takeout and eligible delivery services.
36
+ - id: drugstores
37
+ match: { categories: [drugstore] }
38
+ rate: 3
39
+ - id: lyft
40
+ match: { merchants: [lyft] }
41
+ rate: 2
42
+ valid_to: 2027-09-30
43
+ note: Limited-time offer, for Lyft products bought in the Lyft app.
44
+ # Issuer text backing each rule; `yarn check-sources` checks it weekly.
45
+ evidence:
46
+ - rule: base_rate
47
+ url: https://creditcards.chase.com/cash-back-credit-cards/freedom/unlimited
48
+ quote: 'Earn 1.5% on all other purchases'
49
+ - rule: chase-travel
50
+ url: https://creditcards.chase.com/cash-back-credit-cards/freedom/unlimited
51
+ quote: 'Earn 5% on travel purchased through Chase Travel'
52
+ - rule: dining
53
+ url: https://creditcards.chase.com/cash-back-credit-cards/freedom/unlimited
54
+ quote: 'Earn 3% on dining at restaurants'
55
+ - rule: drugstores
56
+ url: https://creditcards.chase.com/cash-back-credit-cards/freedom/unlimited
57
+ quote: 'Earn 3% on drugstore purchases'
58
+ - rule: lyft
59
+ url: https://creditcards.chase.com/cash-back-credit-cards/freedom/unlimited
60
+ quote: 'earn 2% cash back total on qualifying Lyft products and services'
61
+ - rule: pools_into
62
+ url: https://www.chase.com/personal/credit-cards/education/rewards-benefits/how-to-combine-chase-credit-card-points-in-household
63
+ quote: 'You can combine points from one Chase card to another Chase card on your account'
64
+ - rule: annual_fee
65
+ url: https://creditcards.chase.com/cash-back-credit-cards/freedom/unlimited
66
+ quote: 'ANNUAL FEE $0'
67
+ - rule: welcome_offer
68
+ url: https://creditcards.chase.com/cash-back-credit-cards/freedom/unlimited
69
+ quote: 'Earn a $200 bonus after you spend $500 on purchases in the first 3 months from account opening'
@@ -0,0 +1,77 @@
1
+ id: chase-ihg-one-rewards-business
2
+ name: IHG One Rewards Business Credit Card
3
+ issuer: chase
4
+ network: mastercard
5
+ currency: ihg-points
6
+ last_verified: 2026-10-26
7
+ verified_by: collin
8
+ source_urls:
9
+ - https://creditcards.chase.com/business-credit-cards/IHG/business
10
+ - https://www.chase.com/personal/credit-cards/rewards-category-faq
11
+ base_rate: 3
12
+ business: true
13
+ annual_fee: 200
14
+ welcome_offer:
15
+ points: 190000
16
+ spend: 5000
17
+ months: 3
18
+ note: 'Labeled a launch offer; no end date given. Plus 10,000 points after adding an employee card in the first 3 months. The page and its offer details state no bonus-eligibility rule for this card.'
19
+ rules:
20
+ - id: ihg-hotels
21
+ match: { merchants: [ihg] }
22
+ rate: 10
23
+ note: Card points only. Chase advertises "up to 26X total" at IHG, which adds up to 10X IHG member points and 6X Platinum Elite points that IHG posts for stays booked direct; those aren't card earnings.
24
+ - id: dining-gas-advertising
25
+ match: { categories: [dining, gas, online_advertising] }
26
+ rate: 5
27
+ note: Dining includes takeout and eligible delivery services. Advertising must be bought directly from a social media site or search engine, not through an ad agency.
28
+ - id: flights-direct-and-car-rental
29
+ match: { categories: [travel.flights, travel.car_rental] }
30
+ rate: 5
31
+ note: Airline tickets bought directly from the airline, and car rentals booked directly with the rental agency. Not through travel agencies or online travel sites.
32
+ - id: travel-through-2026
33
+ match: { categories: [travel, transit] }
34
+ rate: 5
35
+ valid_to: 2026-12-31
36
+ note: All of Chase's travel category (which includes trains, buses, taxis and rideshare, tolls and parking) until purchases post after Dec 31, 2026. After that, other travel earns the 3x base rate.
37
+ - id: office-supply-through-2026
38
+ match: { categories: [office_supply] }
39
+ rate: 5
40
+ valid_to: 2026-12-31
41
+ note: Stores that specialize in office supplies. Purchases posting after Dec 31, 2026 earn the 3x base rate.
42
+ evidence:
43
+ - rule: base_rate
44
+ url: https://creditcards.chase.com/business-credit-cards/IHG/business
45
+ quote: 'Earn 3X points per $1 spent on all other purchases.'
46
+ - rule: ihg-hotels
47
+ url: https://creditcards.chase.com/business-credit-cards/IHG/business
48
+ quote: "That's 10X points with this card"
49
+ - rule: ihg-hotels
50
+ url: https://creditcards.chase.com/business-credit-cards/IHG/business
51
+ quote: "You'll earn 10 points for each $1 spent on qualifying purchases made at hotels participating in IHG One Rewards"
52
+ - rule: dining-gas-advertising
53
+ url: https://creditcards.chase.com/business-credit-cards/IHG/business
54
+ quote: 'gas stations; dining at restaurants including takeout and eligible delivery services; social media and search engine advertising'
55
+ - rule: dining-gas-advertising
56
+ url: https://www.chase.com/personal/credit-cards/rewards-category-faq
57
+ quote: 'advertising purchases made through a third party such as an ad agency or web designer'
58
+ - rule: flights-direct-and-car-rental
59
+ url: https://creditcards.chase.com/business-credit-cards/IHG/business
60
+ quote: 'airline tickets when purchased directly with the airline; and car rental agencies'
61
+ - rule: travel-through-2026
62
+ url: https://creditcards.chase.com/business-credit-cards/IHG/business
63
+ quote: 'through December 31, 2026 in the following rewards categories: travel'
64
+ - rule: office-supply-through-2026
65
+ url: https://creditcards.chase.com/business-credit-cards/IHG/business
66
+ quote: 'All other travel purchases and office supply store purchases will earn 3 points for each $1 spent.'
67
+ - rule: office-supply-through-2026
68
+ url: https://creditcards.chase.com/business-credit-cards/IHG/business
69
+ quote: 'and office supply stores. Purchases posted to your account after December 31, 2026'
70
+ - rule: annual_fee
71
+ url: https://creditcards.chase.com/business-credit-cards/IHG/business
72
+ quote: 'ANNUAL FEE $200'
73
+ - rule: welcome_offer
74
+ url: https://creditcards.chase.com/business-credit-cards/IHG/business
75
+ quote: 'Earn 190,000 Bonus Points after spending $5,000 in the first 3 months from account opening'
76
+ todo:
77
+ - The $100 airline statement credit and the up to $100 yearly Expensify credit aren't modeled.
@@ -0,0 +1,44 @@
1
+ id: chase-ihg-one-rewards-premier-select
2
+ name: IHG One Rewards Premier Select Credit Card
3
+ issuer: chase
4
+ network: mastercard
5
+ currency: ihg-points
6
+ last_verified: 2026-10-26
7
+ verified_by: collin
8
+ source_urls:
9
+ - https://creditcards.chase.com/travel-credit-cards/ihg-rewards-club/premier-select
10
+ base_rate: 3
11
+ annual_fee: 350
12
+ welcome_offer:
13
+ points: 200000
14
+ spend: 5000
15
+ months: 3
16
+ note: 'Labeled a launch offer; no end date given. Plus 10,000 points after adding an authorized user in the first 3 months. No free night in the welcome offer; the yearly Anniversary Free Night is a separate perk. Chase: "available to you if you do not have this card and have not received a new Cardmember bonus for this card in the past 24 months."'
17
+ rules:
18
+ - id: ihg-hotels
19
+ match: { merchants: [ihg] }
20
+ rate: 12
21
+ note: Card points only. Chase advertises "up to 28X total" at IHG, which adds up to 10X IHG member points and 6X Platinum Elite points that IHG posts for stays booked direct; those aren't card earnings.
22
+ - id: travel-and-dining
23
+ match: { categories: [travel, transit, dining] }
24
+ rate: 6
25
+ note: Chase's whole travel category, including rideshare, trains, buses, tolls and parking. Dining includes takeout and eligible delivery services.
26
+ evidence:
27
+ - rule: base_rate
28
+ url: https://creditcards.chase.com/travel-credit-cards/ihg-rewards-club/premier-select
29
+ quote: 'Earn 3X points per $1 spent on all other purchases.'
30
+ - rule: ihg-hotels
31
+ url: https://creditcards.chase.com/travel-credit-cards/ihg-rewards-club/premier-select
32
+ quote: "That's 12X points with this card."
33
+ - rule: ihg-hotels
34
+ url: https://creditcards.chase.com/travel-credit-cards/ihg-rewards-club/premier-select
35
+ quote: 'You will only receive the accelerated earn of 12 points for each $1 spent from this credit card program.'
36
+ - rule: travel-and-dining
37
+ url: https://creditcards.chase.com/travel-credit-cards/ihg-rewards-club/premier-select
38
+ quote: 'Earn 6X points on dining and all other travel, including rideshare.'
39
+ - rule: annual_fee
40
+ url: https://creditcards.chase.com/travel-credit-cards/ihg-rewards-club/premier-select
41
+ quote: 'ANNUAL FEE $350'
42
+ - rule: welcome_offer
43
+ url: https://creditcards.chase.com/travel-credit-cards/ihg-rewards-club/premier-select
44
+ quote: 'Earn 200,000 Bonus Points after you spend $5,000 on purchases in the first 3 months from account opening'
@@ -0,0 +1,68 @@
1
+ id: chase-ihg-one-rewards-premier
2
+ name: IHG One Rewards Premier Credit Card
3
+ issuer: chase
4
+ network: mastercard
5
+ currency: ihg-points
6
+ last_verified: 2026-10-26
7
+ verified_by: collin
8
+ source_urls:
9
+ - https://creditcards.chase.com/travel-credit-cards/ihg-rewards-club/premier
10
+ - https://www.chase.com/personal/credit-cards/rewards-category-faq
11
+ base_rate: 3
12
+ annual_fee: 150
13
+ welcome_offer:
14
+ points: 180000
15
+ spend: 3000
16
+ months: 3
17
+ note: 'Labeled a launch offer; no end date given. Plus 10,000 points after adding an authorized user in the first 3 months. No free night in the welcome offer; the yearly Anniversary Free Night is a separate perk. Chase: "available to you if you do not have any personal IHG One Rewards Credit Cards and have not received a new Cardmember bonus within the last 24 months. This does not apply to Business Card Credit Card products."'
18
+ rules:
19
+ - id: ihg-hotels
20
+ match: { merchants: [ihg] }
21
+ rate: 10
22
+ note: Card points only. Chase advertises "up to 24X total" at IHG, which adds up to 10X IHG member points and 4X Gold Elite points that IHG posts for stays booked direct; those aren't card earnings.
23
+ - id: dining-grocery-gas
24
+ match: { categories: [dining, grocery.supermarket, gas] }
25
+ rate: 5
26
+ note: Dining includes takeout and eligible delivery services. Chase's grocery stores exclude warehouse clubs, discount stores, drugstores and gas at grocery-store stations; delivery services count only if they code as a grocery store.
27
+ - id: flights-direct-and-car-rental
28
+ match: { categories: [travel.flights, travel.car_rental] }
29
+ rate: 5
30
+ note: Airline tickets bought directly from the airline, and car rentals booked directly with the rental agency. Not through travel agencies or online travel sites.
31
+ - id: travel-through-2026
32
+ match: { categories: [travel, transit] }
33
+ rate: 5
34
+ valid_to: 2026-12-31
35
+ note: All of Chase's travel category (which includes trains, buses, taxis and rideshare, tolls and parking) until purchases post after Dec 31, 2026. After that, other travel earns the 3x base rate.
36
+ evidence:
37
+ - rule: base_rate
38
+ url: https://creditcards.chase.com/travel-credit-cards/ihg-rewards-club/premier
39
+ quote: 'Earn 3X points per $1 spent on all other purchases.'
40
+ - rule: ihg-hotels
41
+ url: https://creditcards.chase.com/travel-credit-cards/ihg-rewards-club/premier
42
+ quote: "You'll earn 10 points for each $1 spent on qualifying purchases made at hotels participating in IHG One Rewards"
43
+ - rule: ihg-hotels
44
+ url: https://creditcards.chase.com/travel-credit-cards/ihg-rewards-club/premier
45
+ quote: "That's 10X points with this card."
46
+ - rule: dining-grocery-gas
47
+ url: https://creditcards.chase.com/travel-credit-cards/ihg-rewards-club/premier
48
+ quote: 'the following rewards categories: grocery stores; gas stations; dining at restaurants'
49
+ - rule: dining-grocery-gas
50
+ url: https://www.chase.com/personal/credit-cards/rewards-category-faq
51
+ quote: 'Delivery service merchants will be included if they classify as a grocery store merchant.'
52
+ - rule: flights-direct-and-car-rental
53
+ url: https://creditcards.chase.com/travel-credit-cards/ihg-rewards-club/premier
54
+ quote: 'airline tickets when purchased directly with the airline; and car rental agencies'
55
+ - rule: travel-through-2026
56
+ url: https://creditcards.chase.com/travel-credit-cards/ihg-rewards-club/premier
57
+ quote: 'purchases that post to your account through December 31, 2026 in the travel rewards category'
58
+ - rule: travel-through-2026
59
+ url: https://creditcards.chase.com/travel-credit-cards/ihg-rewards-club/premier
60
+ quote: 'All other travel purchases will earn 3 points for each $1 spent.'
61
+ - rule: annual_fee
62
+ url: https://creditcards.chase.com/travel-credit-cards/ihg-rewards-club/premier
63
+ quote: 'ANNUAL FEE $150'
64
+ - rule: welcome_offer
65
+ url: https://creditcards.chase.com/travel-credit-cards/ihg-rewards-club/premier
66
+ quote: 'Earn 180,000 Bonus Points after you spend $3,000 on purchases in the first 3 months from account opening'
67
+ todo:
68
+ - The $100 airline statement credit (after $250 on flights bought directly each calendar year, through 12/31/27) isn't modeled.