earnrate 0.2.11 → 0.2.13

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 (158) hide show
  1. package/README.md +37 -12
  2. package/data/CHANGELOG.md +291 -0
  3. package/data/VERSION +1 -1
  4. package/data/cards/amex-blue-business-plus.yaml +1 -0
  5. package/data/cards/amex-blue-cash-everyday.yaml +29 -2
  6. package/data/cards/amex-blue-cash-preferred.yaml +26 -0
  7. package/data/cards/amex-business-gold.yaml +169 -0
  8. package/data/cards/amex-business-platinum.yaml +184 -0
  9. package/data/cards/amex-delta-skymiles-blue.yaml +91 -0
  10. package/data/cards/amex-delta-skymiles-gold.yaml +29 -1
  11. package/data/cards/amex-delta-skymiles-platinum.yaml +35 -1
  12. package/data/cards/amex-delta-skymiles-reserve.yaml +35 -1
  13. package/data/cards/amex-gold.yaml +53 -0
  14. package/data/cards/amex-hilton-honors-aspire.yaml +25 -1
  15. package/data/cards/amex-hilton-honors-business.yaml +106 -0
  16. package/data/cards/amex-hilton-honors-surpass.yaml +16 -1
  17. package/data/cards/amex-hilton-honors.yaml +2 -0
  18. package/data/cards/amex-marriott-bonvoy-bevy.yaml +2 -0
  19. package/data/cards/amex-marriott-bonvoy-brilliant.yaml +17 -1
  20. package/data/cards/amex-marriott-bonvoy-business.yaml +116 -0
  21. package/data/cards/amex-platinum.yaml +111 -0
  22. package/data/cards/apple-card.yaml +76 -0
  23. package/data/cards/bank-of-america-atmos-rewards-ascent.yaml +1 -0
  24. package/data/cards/bank-of-america-atmos-rewards-business.yaml +2 -0
  25. package/data/cards/bank-of-america-atmos-rewards-summit.yaml +1 -0
  26. package/data/cards/bank-of-america-customized-cash-rewards.yaml +34 -1
  27. package/data/cards/bank-of-america-premium-rewards.yaml +134 -0
  28. package/data/cards/bank-of-america-travel-rewards.yaml +123 -0
  29. package/data/cards/bank-of-america-unlimited-cash-rewards.yaml +83 -0
  30. package/data/cards/barclays-jetblue-plus.yaml +86 -0
  31. package/data/cards/bilt-blue.yaml +60 -0
  32. package/data/cards/bilt-obsidian.yaml +13 -2
  33. package/data/cards/bilt-palladium.yaml +86 -0
  34. package/data/cards/caltech-efcu-platinum-mastercard.yaml +50 -0
  35. package/data/cards/capital-one-kohls-card.yaml +1 -0
  36. package/data/cards/capital-one-kohls-rewards-visa.yaml +1 -0
  37. package/data/cards/capital-one-quicksilver.yaml +2 -0
  38. package/data/cards/capital-one-rei-co-op-mastercard.yaml +62 -0
  39. package/data/cards/capital-one-savor.yaml +2 -0
  40. package/data/cards/capital-one-spark-cash-plus.yaml +80 -0
  41. package/data/cards/capital-one-venture-x-business.yaml +124 -0
  42. package/data/cards/capital-one-venture-x.yaml +32 -2
  43. package/data/cards/capital-one-venture.yaml +2 -0
  44. package/data/cards/chase-aeroplan.yaml +16 -0
  45. package/data/cards/chase-freedom-flex.yaml +1 -0
  46. package/data/cards/chase-freedom-rise.yaml +29 -0
  47. package/data/cards/chase-freedom-unlimited.yaml +1 -0
  48. package/data/cards/chase-ihg-one-rewards-business.yaml +28 -1
  49. package/data/cards/chase-ihg-one-rewards-premier-select.yaml +18 -0
  50. package/data/cards/chase-ihg-one-rewards-premier.yaml +16 -0
  51. package/data/cards/chase-ihg-one-rewards.yaml +1 -0
  52. package/data/cards/chase-ink-business-cash.yaml +14 -0
  53. package/data/cards/chase-ink-business-preferred.yaml +1 -0
  54. package/data/cards/chase-ink-business-unlimited.yaml +80 -0
  55. package/data/cards/chase-marriott-bonvoy-bold.yaml +1 -0
  56. package/data/cards/chase-marriott-bonvoy-boundless.yaml +2 -0
  57. package/data/cards/chase-prime-visa.yaml +1 -0
  58. package/data/cards/chase-sapphire-preferred.yaml +12 -0
  59. package/data/cards/chase-sapphire-reserve.yaml +45 -4
  60. package/data/cards/chase-southwest-performance-business.yaml +2 -0
  61. package/data/cards/chase-southwest-plus.yaml +2 -0
  62. package/data/cards/chase-southwest-premier-business.yaml +2 -0
  63. package/data/cards/chase-southwest-premier.yaml +2 -0
  64. package/data/cards/chase-southwest-priority.yaml +2 -0
  65. package/data/cards/chase-united-business.yaml +33 -0
  66. package/data/cards/chase-united-club-business.yaml +41 -0
  67. package/data/cards/chase-united-club.yaml +41 -0
  68. package/data/cards/chase-united-explorer.yaml +33 -0
  69. package/data/cards/chase-united-gateway.yaml +1 -0
  70. package/data/cards/chase-united-quest.yaml +41 -0
  71. package/data/cards/citi-aadvantage-business.yaml +2 -0
  72. package/data/cards/citi-aadvantage-executive.yaml +28 -1
  73. package/data/cards/citi-aadvantage-globe.yaml +2 -0
  74. package/data/cards/citi-aadvantage-mileup.yaml +2 -0
  75. package/data/cards/citi-aadvantage-platinum-select.yaml +2 -0
  76. package/data/cards/citi-costco-anywhere-visa-business.yaml +2 -0
  77. package/data/cards/citi-costco-anywhere-visa.yaml +2 -0
  78. package/data/cards/citi-custom-cash.yaml +1 -0
  79. package/data/cards/citi-double-cash.yaml +1 -0
  80. package/data/cards/citi-my-best-buy-visa.yaml +1 -0
  81. package/data/cards/citi-strata-elite.yaml +21 -1
  82. package/data/cards/citi-strata-premier.yaml +1 -0
  83. package/data/cards/citi-strata.yaml +164 -0
  84. package/data/cards/discover-it-cash-back.yaml +22 -3
  85. package/data/cards/fidelity-rewards-visa-signature.yaml +60 -0
  86. package/data/cards/navy-federal-cash-rewards-plus.yaml +61 -0
  87. package/data/cards/navy-federal-cash-rewards.yaml +60 -0
  88. package/data/cards/navy-federal-more-rewards-amex.yaml +92 -0
  89. package/data/cards/paypal-cashback-mastercard.yaml +52 -0
  90. package/data/cards/penfed-power-cash-rewards.yaml +47 -0
  91. package/data/cards/sams-club-mastercard.yaml +68 -0
  92. package/data/cards/sofi-unlimited-2.yaml +1 -0
  93. package/data/cards/td-bank-nordstrom-credit-card.yaml +1 -0
  94. package/data/cards/td-bank-nordstrom-visa.yaml +1 -0
  95. package/data/cards/td-bank-target-circle-card.yaml +1 -0
  96. package/data/cards/usbank-altitude-connect.yaml +156 -0
  97. package/data/cards/usbank-altitude-go.yaml +124 -0
  98. package/data/cards/usbank-cash-plus.yaml +1 -0
  99. package/data/cards/usbank-smartly.yaml +107 -0
  100. package/data/cards/venmo-credit-card.yaml +151 -0
  101. package/data/cards/verizon-visa-card.yaml +122 -0
  102. package/data/cards/wells-fargo-active-cash.yaml +1 -0
  103. package/data/cards/wells-fargo-autograph-journey.yaml +73 -0
  104. package/data/cards/wells-fargo-autograph.yaml +1 -0
  105. package/data/categories.yaml +3 -1
  106. package/data/currencies.yaml +48 -0
  107. package/data/issuers.yaml +44 -1
  108. package/data/memberships.yaml +45 -0
  109. package/data/merchants/overrides.yaml +947 -1
  110. package/data/merchants/seed.yaml +1916 -62
  111. package/dist/cli/args.js +18 -0
  112. package/dist/cli/explore.js +10 -1
  113. package/dist/cli/import.js +2 -2
  114. package/dist/cli/run.js +4 -1
  115. package/dist/cli/wallet.js +37 -3
  116. package/dist/data/file-store.js +5 -2
  117. package/dist/data/integrity.js +59 -0
  118. package/dist/data/store.js +4 -1
  119. package/dist/data/wallet-edit.js +28 -7
  120. package/dist/engine/cheat-sheet.js +17 -5
  121. package/dist/engine/checklist.js +38 -6
  122. package/dist/engine/credits.js +65 -0
  123. package/dist/engine/evaluate.js +57 -18
  124. package/dist/engine/explore.js +70 -7
  125. package/dist/engine/intro.js +36 -0
  126. package/dist/engine/offers.js +2 -1
  127. package/dist/engine/periods.js +10 -3
  128. package/dist/engine/recommend.js +101 -20
  129. package/dist/engine/record.js +43 -1
  130. package/dist/engine/rotation.js +3 -0
  131. package/dist/engine/rule-text.js +28 -3
  132. package/dist/engine/setup.js +20 -3
  133. package/dist/engine/simulate.js +10 -1
  134. package/dist/engine/text.js +107 -0
  135. package/dist/engine/wallet-change.js +57 -4
  136. package/dist/engine/wallet-summary.js +54 -6
  137. package/dist/format/card-art.js +21 -0
  138. package/dist/format/card-text.js +4 -3
  139. package/dist/format/cards.js +1 -0
  140. package/dist/format/cheat-sheet.js +2 -0
  141. package/dist/format/explore.js +20 -4
  142. package/dist/format/recommendation.js +6 -2
  143. package/dist/format/wallet-yaml.js +1 -0
  144. package/dist/format/wallet.js +15 -5
  145. package/dist/import/analyze.js +8 -2
  146. package/dist/mcp/inputs.js +13 -0
  147. package/dist/mcp/prompts.js +9 -1
  148. package/dist/mcp/schemas.js +87 -1
  149. package/dist/mcp/tools/account.js +3 -1
  150. package/dist/mcp/tools/answers.js +9 -4
  151. package/dist/mcp/tools/wallet.js +20 -8
  152. package/dist/merchants/resolve.js +8 -0
  153. package/dist/schema/card.js +60 -3
  154. package/dist/schema/common.js +1 -1
  155. package/dist/schema/issuer.js +4 -0
  156. package/dist/schema/merchant.js +3 -0
  157. package/dist/schema/wallet.js +11 -0
  158. package/package.json +12 -3
@@ -0,0 +1,107 @@
1
+ id: usbank-smartly
2
+ name: U.S. Bank Smartly Visa Signature Card
3
+ short_name: U.S. Bank Smartly
4
+ color: '#16171b'
5
+ issuer: usbank
6
+ network: visa
7
+ # Earned as points, 1 point per 1% of cash back, worth full value as a
8
+ # deposit to a U.S. Bank account (see todo on statement credits).
9
+ currency: cash
10
+ last_verified: 2026-11-04
11
+ verified_by: claude
12
+ source_urls:
13
+ - https://www.usbank.com/credit-cards/bank-smartly-visa-signature-credit-card.html
14
+ - https://rewards.usbank.com/benefits/card/SmartlyBenefits/program-rules
15
+ - https://onboarding.usbank.com/gateway/partner/credit-card/begin?locationCode=8069&offerId=36672BDX52&sourceCode=87869&page=terms
16
+ base_rate: 2
17
+ annual_fee: 0
18
+ foreign_transaction_fee: 3
19
+ caps:
20
+ # The Smartly Earning Bonus counts only the first $10,000 of eligible net
21
+ # purchases a billing cycle; past it every tier earns the base 2%.
22
+ - id: smartly-earning-bonus
23
+ amount: 10000
24
+ period: month
25
+ then_rate: 2
26
+ rules:
27
+ # Smartly Earning Bonus tiers, by the 30-day average balance in Bank
28
+ # Smartly Checking and Safe Debit, with a Bank Smartly Savings account.
29
+ - id: everything-smartly-25
30
+ match: { any: true }
31
+ rate: 2.5
32
+ cap: smartly-earning-bonus
33
+ requires: { membership: usbank-smartly-25 }
34
+ note: 2% plus the 25% Smartly Earning Bonus (a qualifying balance from $10,000 per the card page, $5,000 per the program rules, to $49,999.99), on the first $10,000 of eligible net purchases each billing cycle. Education, gift cards, insurance, tax, business-to-business merchants and third-party bill payment earn 2% and don't count toward the $10,000.
35
+ - id: everything-smartly-50
36
+ match: { any: true }
37
+ rate: 3
38
+ cap: smartly-earning-bonus
39
+ requires: { membership: usbank-smartly-50 }
40
+ note: 2% plus the 50% Smartly Earning Bonus (qualifying balance $50,000 to $99,999.99), on the first $10,000 of eligible net purchases each billing cycle. Education, gift cards, insurance, tax, business-to-business merchants and third-party bill payment earn 2% and don't count toward the $10,000.
41
+ - id: everything-smartly-100
42
+ match: { any: true }
43
+ rate: 4
44
+ cap: smartly-earning-bonus
45
+ requires: { membership: usbank-smartly-100 }
46
+ note: 2% plus the 100% Smartly Earning Bonus (qualifying balance $100,000 or more), on the first $10,000 of eligible net purchases each billing cycle. Education, gift cards, insurance, tax, business-to-business merchants and third-party bill payment earn 2% and don't count toward the $10,000.
47
+ - id: travel-center-hotels-car-rentals
48
+ match:
49
+ {
50
+ merchants:
51
+ [usbank-travel-center-hotels, usbank-travel-center-car-rentals],
52
+ }
53
+ rate: 6
54
+ note: Prepaid hotels and car rentals booked in the U.S. Bank Travel Center with this card, 4 extra points on top of the base 2. Air isn't included.
55
+ # Issuer text backing each rule; `yarn check-sources` checks it weekly.
56
+ evidence:
57
+ - rule: base_rate
58
+ url: https://www.usbank.com/credit-cards/bank-smartly-visa-signature-credit-card.html
59
+ quote: 'Earn unlimited 2% cash back on every purchase.'
60
+ - rule: base_rate
61
+ url: https://rewards.usbank.com/benefits/card/SmartlyBenefits/program-rules
62
+ quote: 'Maximum Point value applies to Points redeemed for a deposit into an eligible checking, savings or money market account'
63
+ - rule: everything-smartly-25
64
+ url: https://www.usbank.com/credit-cards/bank-smartly-visa-signature-credit-card.html
65
+ quote: 'Includes a 25% Smartly Earning Bonus with a qualifying balance between $10,000 and $49,999.'
66
+ - rule: everything-smartly-25
67
+ url: https://www.usbank.com/credit-cards/bank-smartly-visa-signature-credit-card.html
68
+ quote: 'Have or open a U.S. Bank Smartly® Savings account with a minimum opening deposit of $25'
69
+ - rule: everything-smartly-25
70
+ url: https://www.usbank.com/credit-cards/bank-smartly-visa-signature-credit-card.html
71
+ quote: 'Smartly Earning Bonus applies to a maximum of $10,000 in eligible Net Purchases each Card billing cycle.'
72
+ - rule: everything-smartly-25
73
+ url: https://www.usbank.com/credit-cards/bank-smartly-visa-signature-credit-card.html
74
+ quote: 'Purchases classified as (1) education/school, gift cards (including discount gift card sites), insurance, or tax'
75
+ - rule: everything-smartly-25
76
+ url: https://www.usbank.com/credit-cards/bank-smartly-visa-signature-credit-card.html
77
+ quote: 'These Purchases are not calculated as part of the $10,000 cap.'
78
+ - rule: everything-smartly-50
79
+ url: https://www.usbank.com/credit-cards/bank-smartly-visa-signature-credit-card.html
80
+ quote: 'Includes a 50% Smartly Earning Bonus with a qualifying balance between $50,000 and $99,999.'
81
+ - rule: everything-smartly-50
82
+ url: https://rewards.usbank.com/benefits/card/SmartlyBenefits/program-rules
83
+ quote: 'a base of 2 Points plus the Smartly Earning Bonus of 1 Point'
84
+ - rule: everything-smartly-100
85
+ url: https://www.usbank.com/credit-cards/bank-smartly-visa-signature-credit-card.html
86
+ quote: 'Includes a 100% Smartly Earning Bonus with a qualifying balance of $100,000 or more.'
87
+ - rule: everything-smartly-100
88
+ url: https://rewards.usbank.com/benefits/card/SmartlyBenefits/program-rules
89
+ quote: 'a base of 2 Points plus the Smartly Earning Bonus of 2 Points'
90
+ - rule: travel-center-hotels-car-rentals
91
+ url: https://rewards.usbank.com/benefits/card/SmartlyBenefits/program-rules
92
+ quote: 'Earn 4 more Points on hotels and car rentals booked directly on the Travel Center website.'
93
+ - rule: travel-center-hotels-car-rentals
94
+ url: https://rewards.usbank.com/benefits/card/SmartlyBenefits/program-rules
95
+ quote: 'spent on prepaid car and hotel reservations made on the Travel Center website'
96
+ - rule: annual_fee
97
+ url: https://www.usbank.com/credit-cards/bank-smartly-visa-signature-credit-card.html
98
+ quote: 'Enjoy a cash back credit card with no annual fee'
99
+ - rule: foreign_transaction_fee
100
+ url: https://onboarding.usbank.com/gateway/partner/credit-card/begin?locationCode=8069&offerId=36672BDX52&sourceCode=87869&page=terms
101
+ quote: 'Foreign Transaction 3% of each foreign transaction'
102
+ todo:
103
+ - 'The card page puts the 2.5% tier at a qualifying balance of $10,000 to $49,999; the program rules page says "Between $5,000 - $49,999.99". The tier memberships (usbank-smartly-25, -50, -100) are named by rate, so a wallet picks its tier either way; which threshold applies is unconfirmed.'
104
+ - "Bonus exclusions aren't modeled: education, gift cards, insurance, tax, business-to-business merchants and third-party bill payment earn 2% at every tier and don't use the $10,000, but earnrate has no categories for them, so the tier rules apply to them."
105
+ - 'Points are worth full value only as a deposit to a U.S. Bank checking, savings or money market account. The card page also lists statement credits at that value; the program rules say statement credits may be at a reduced rate, without saying what. Modeled as cash at 1¢.'
106
+ - 'Whether the Smartly Earning Bonus also applies to Travel Center hotels and car rentals (which would make them 6.5% to 8%) is unstated: the 4 extra points are "in addition to your base earn". Modeled at 6% for every tier.'
107
+ - 'The tier can change within a billing cycle as the 30-day average balance moves; earnrate takes the tier the wallet says.'
@@ -0,0 +1,151 @@
1
+ id: venmo-credit-card
2
+ name: Venmo Credit Card
3
+ color: '#1a7fe0'
4
+ # Issued by Synchrony Bank as a Visa or Visa Signature; cash back lands in the
5
+ # linked Venmo balance daily. The categories have been fixed since the
6
+ # rewards terms' 6/2026 revision (no more automatic top category).
7
+ issuer: synchrony
8
+ network: visa
9
+ currency: cash
10
+ last_verified: 2026-11-04
11
+ verified_by: claude
12
+ source_urls:
13
+ - https://venmo.com/about/creditcard/
14
+ - https://venmo.com/about/creditcard/rewards
15
+ - https://www.synchronybankterms.com/syfterms/html/VCCRewardsTerms.htm
16
+ - https://www.synchronybankterms.com/syfterms/html/VenmoVCCApplyTerms_combo.htm
17
+ base_rate: 1
18
+ annual_fee: 0
19
+ foreign_transaction_fee: 0
20
+ rules:
21
+ - id: dining-nightlife
22
+ match: { categories: [dining] }
23
+ rate: 3
24
+ note: Restaurants and quick-serve restaurants, for dining in, carryout, drive-through or delivery, plus bars. Set by merchant category code, so a cafe inside a gas station may not count. Venmo's pages also name bakeries and liquor stores, which the Synchrony terms don't.
25
+ - id: entertainment
26
+ match:
27
+ {
28
+ categories:
29
+ [entertainment, movie_theaters, streaming, fitness, sporting_goods],
30
+ }
31
+ rate: 3
32
+ note: Movie theaters, concert and theatrical promoters, pro sports, streaming and other subscription TV, radio or streaming, sporting goods stores, and membership sports and recreation clubs (gyms, golf, tennis, swimming).
33
+ - id: entertainment-other
34
+ # Visa's codes for the rest of Venmo's "Eligible entertainment
35
+ # categories" list. Betting (7995) is on the list but Synchrony treats
36
+ # gambling as a cash advance, which earns nothing.
37
+ match:
38
+ {
39
+ mccs:
40
+ [
41
+ 5192,
42
+ 5735,
43
+ 5811,
44
+ 5815,
45
+ 5816,
46
+ 5817,
47
+ 5818,
48
+ 5945,
49
+ 5972,
50
+ 5994,
51
+ 5998,
52
+ 7032,
53
+ 7033,
54
+ 7841,
55
+ 7911,
56
+ 7929,
57
+ 7932,
58
+ 7933,
59
+ 7991,
60
+ 7992,
61
+ 7993,
62
+ 7994,
63
+ 7996,
64
+ 7998,
65
+ 7999,
66
+ ],
67
+ }
68
+ rate: 3
69
+ note: Also entertainment to Venmo, by merchant category code. Books, periodicals and newspapers, record stores, caterers, digital goods (books, movies, music, games and apps), hobby, toy and game stores, stamp and coin stores, newsstands, tent and awning shops, camps and campgrounds, video rental, dance halls and studios, bands, billiards, bowling, tourist attractions, public golf courses, arcades, amusement parks, aquariums and recreation services.
70
+ todo:
71
+ - "3% when the card is the linked payment method in Venmo (Venmo checkout online, paying a business profile, or a goods-and-services payment) isn't modeled: earnrate sees the merchant and channel, not how a purchase is paid, so those purchases get their category rate here. Venmo personal payments funded by the card earn 1%."
72
+ - "An extra 1% on dining and entertainment (4% in all) when the purchase is split with another Venmo user in the app and everyone pays within 30 days isn't modeled."
73
+ - "Cable, satellite and pay TV (MCC 4899, on Venmo's list) earns 3%, but earnrate's TV-and-internet category also covers internet service, which Venmo's page puts at 1% under bills, so only the streaming category is in the rule."
74
+ - "Purchases through a third-party payment account, card reader or digital wallet that doesn't pass the merchant category code earn 1%."
75
+ - "The MCC numbers in entertainment-other are Visa's codes for the category names on Venmo's rewards page, which lists names only."
76
+ evidence:
77
+ - rule: base_rate
78
+ url: https://www.synchronybankterms.com/syfterms/html/VCCRewardsTerms.htm
79
+ quote: '1%: Other. All other Eligible Purchases made where Visa credit cards are accepted will earn 1% Cash Rewards.'
80
+ - rule: base_rate
81
+ url: https://www.synchronybankterms.com/syfterms/html/VCCRewardsTerms.htm
82
+ quote: 'there is no maximum amount of Eligible Purchases that may earn Cash Rewards.'
83
+ - rule: base_rate
84
+ url: https://venmo.com/about/creditcard/
85
+ quote: 'You’ll earn 1% cash back on all other purchases with your card.'
86
+ - rule: dining-nightlife
87
+ url: https://www.synchronybankterms.com/syfterms/html/VCCRewardsTerms.htm
88
+ quote: 'All Eligible Purchases made in Dining & Nightlife will earn 3% Cash Rewards.'
89
+ - rule: dining-nightlife
90
+ url: https://www.synchronybankterms.com/syfterms/html/VCCRewardsTerms.htm
91
+ quote: 'restaurants and quick serve restaurants that sell prepared food and drinks'
92
+ - rule: dining-nightlife
93
+ url: https://www.synchronybankterms.com/syfterms/html/VCCRewardsTerms.htm
94
+ quote: 'the café of a gas station may have an MCC as a type of merchant other than a restaurant'
95
+ - rule: dining-nightlife
96
+ url: https://venmo.com/about/creditcard/
97
+ quote: 'Earn 3% cash back on dining and entertainment.'
98
+ - rule: entertainment
99
+ url: https://www.synchronybankterms.com/syfterms/html/VCCRewardsTerms.htm
100
+ quote: 'All Eligible Purchases made in Entertainment will earn 3% Cash Rewards.'
101
+ - rule: entertainment
102
+ url: https://www.synchronybankterms.com/syfterms/html/VCCRewardsTerms.htm
103
+ quote: 'Entertainment includes movie theaters, theatrical and concert promoters, video game rental stores'
104
+ - rule: entertainment
105
+ url: https://www.synchronybankterms.com/syfterms/html/VCCRewardsTerms.htm
106
+ quote: 'ongoing delivery of television/radio/streaming content on a subscription or fee basis'
107
+ - rule: entertainment
108
+ url: https://www.synchronybankterms.com/syfterms/html/VCCRewardsTerms.htm
109
+ quote: 'sports and recreation facilities that require membership such as health clubs'
110
+ - rule: entertainment
111
+ url: https://venmo.com/about/creditcard/rewards
112
+ quote: 'Sporting Goods Stores Hobby, Toy & Game Stores'
113
+ - rule: entertainment-other
114
+ url: https://www.synchronybankterms.com/syfterms/html/VCCRewardsTerms.htm
115
+ quote: 'digital goods such as books, movies, music and games, books and newsstands, amusement parks'
116
+ - rule: entertainment-other
117
+ url: https://venmo.com/about/creditcard/rewards
118
+ quote: 'Books / Periodicals / Newspapers Record Stores'
119
+ - rule: entertainment-other
120
+ url: https://venmo.com/about/creditcard/rewards
121
+ quote: 'Stamp & Coin Stores News Dealers / Newsstands Tent And Awning Shops'
122
+ - rule: entertainment-other
123
+ url: https://venmo.com/about/creditcard/rewards
124
+ quote: 'Sporting / Recreational Camps Trailer Parks / Campgrounds'
125
+ - rule: entertainment-other
126
+ url: https://venmo.com/about/creditcard/rewards
127
+ quote: 'DVD / Video Tape Rental Stores Dance Halls / Studios / Schools'
128
+ - rule: entertainment-other
129
+ url: https://venmo.com/about/creditcard/rewards
130
+ quote: 'Bands / Orchestras / Entertain Billiard / Pool Establishment Bowling Alleys'
131
+ - rule: entertainment-other
132
+ url: https://venmo.com/about/creditcard/rewards
133
+ quote: 'Tourist Attractions and Exhibits Public Golf Courses Video Amusement Game Supply'
134
+ - rule: entertainment-other
135
+ url: https://venmo.com/about/creditcard/rewards
136
+ quote: 'Amusement Parks / Circus Aquariums / Seaquariums Recreation Services Caterers'
137
+ - rule: entertainment-other
138
+ url: https://venmo.com/about/creditcard/rewards
139
+ quote: 'Digital Goods: Applications (Excludes Games) Large Digital Goods Merchant'
140
+ - rule: entertainment-other
141
+ url: https://www.synchronybankterms.com/syfterms/html/VenmoVCCApplyTerms_combo.htm
142
+ quote: 'lottery tickets or other legalized gambling transactions'
143
+ - rule: annual_fee
144
+ url: https://www.synchronybankterms.com/syfterms/html/VenmoVCCApplyTerms_combo.htm
145
+ quote: 'Fees Annual Fee None Transaction Fees'
146
+ - rule: foreign_transaction_fee
147
+ url: https://www.synchronybankterms.com/syfterms/html/VenmoVCCApplyTerms_combo.htm
148
+ quote: 'Foreign Transaction Fee We will not charge you a foreign transaction fee.'
149
+ - rule: foreign_transaction_fee
150
+ url: https://venmo.com/about/creditcard/
151
+ quote: 'No foreign transaction fee 2 Spend when you travel.'
@@ -0,0 +1,122 @@
1
+ id: verizon-visa-card
2
+ name: Verizon Visa Card
3
+ color: '#1c1c1c'
4
+ # Issued by Synchrony Bank as a Visa Signature. Rewards are Verizon Dollars,
5
+ # which redeem at $1 for a $1 statement credit on the card, or toward Verizon
6
+ # bills, devices and accessories, so a Verizon Dollar is 1¢ per cent earned
7
+ # here. Earning and redeeming need an active Verizon account.
8
+ issuer: synchrony
9
+ network: visa
10
+ currency: cash
11
+ last_verified: 2026-11-04
12
+ verified_by: claude
13
+ source_urls:
14
+ - https://www.verizon.com/financial-services/verizon-visa-card/
15
+ - https://www.verizon.com/support/verizon-visa-card-rewards-legal/
16
+ - https://www.verizon.com/support/verizon-visa-card-faqs/
17
+ base_rate: 1
18
+ annual_fee: 0
19
+ foreign_transaction_fee: 0
20
+ requires_membership: verizon-account
21
+ welcome_offer:
22
+ dollars: 150
23
+ spend: 0
24
+ months: 3
25
+ valid_to: 2027-01-13
26
+ note: 'A $150 statement credit after one purchase within 90 days of opening, for applicants approved 8/12/26 to 1/13/27; spend 0 stands in for "make one purchase". One offer per account; the credit posts 1-2 billing cycles after the purchase.'
27
+ rules:
28
+ - id: gas-ev-charging
29
+ match: { categories: [gas, ev_charging] }
30
+ rate: 4
31
+ note: Merchants coded as service stations or automated fuel dispensers, and EV charging stations. Not aviation or other non-automotive fuel. EV charging billed by a parking lot or garage can code as parking and earn 1%.
32
+ - id: grocery-stores
33
+ match: { categories: [grocery.supermarket] }
34
+ rate: 4
35
+ note: Grocery stores and supermarkets, by merchant category code. Groceries at Walmart, Target and other big-box stores may not count.
36
+ - id: restaurants
37
+ match: { categories: [dining] }
38
+ rate: 4
39
+ note: Restaurants, drinking places and fast food, including takeout and delivery. A cafe inside another store can code as that store and earn 1%.
40
+ - id: caterers
41
+ match: { mccs: [5811] }
42
+ rate: 4
43
+ note: Caterers count as restaurants.
44
+ - id: verizon-purchases
45
+ match: { merchants: [verizon-store] }
46
+ rate: 4
47
+ note: Devices and accessories bought at a Verizon store, Verizon online, by phone with Verizon or at an exclusive Verizon Authorized Retailer. Not Verizon wireless or Fios bill payments, or items charged to those bills, which earn 1%. Not Verizon services sold at big-box stores like Walmart or Best Buy.
48
+ todo:
49
+ - "No readable Synchrony rates-and-fees table: the application's pricing terms are only inside the apply flow, and no synchronybankterms.com page for this card was found. The no-fee and no-foreign-fee quotes are from Verizon's own pages."
50
+ - 'Verizon Dollars are forfeited if the Verizon wireless or Fios account closes, if the cardholder stops being its Account Owner or Manager, after 90 days if the card closes, or after 24 months with no card or rewards activity. Once Verizon service ends, the card earns nothing.'
51
+ - 'Card benefits not modeled: Auto Pay discounts of up to $10 a month per line when paying the Verizon bill with the card, 2 free TravelPass days a year, and 0% device financing over 36 months.'
52
+ - "Verizon Loyalty's separate 3% in Verizon Dollars on the Verizon bill comes with being a customer, not with the card, so it isn't counted."
53
+ evidence:
54
+ - rule: base_rate
55
+ url: https://www.verizon.com/support/verizon-visa-card-rewards-legal/
56
+ quote: '1% in Verizon Dollars for all other Net New Purchases made on your Credit Card Account'
57
+ - rule: base_rate
58
+ url: https://www.verizon.com/support/verizon-visa-card-rewards-legal/
59
+ quote: 'There is no limit on earning Verizon Dollars for any of the Net New Purchases listed above.'
60
+ - rule: base_rate
61
+ url: https://www.verizon.com/support/verizon-visa-card-faqs/
62
+ quote: '$1 Verizon Dollar = $1 Statement Credit'
63
+ - rule: base_rate
64
+ url: https://www.verizon.com/support/verizon-visa-card-faqs/
65
+ quote: 'Cardholders can redeem available Verizon Dollars as a statement credit toward the current balance'
66
+ - rule: base_rate
67
+ url: https://www.verizon.com/support/verizon-visa-card-rewards-legal/
68
+ quote: '1% in Verizon Dollars for every Net New Purchase made for the payment of your Verizon Wireless Account bill'
69
+ - rule: gas-ev-charging
70
+ url: https://www.verizon.com/support/verizon-visa-card-rewards-legal/
71
+ quote: '4% in Verizon Dollars for every Net New Purchase of gas and at electric vehicle'
72
+ - rule: gas-ev-charging
73
+ url: https://www.verizon.com/support/verizon-visa-card-rewards-legal/
74
+ quote: 'Gas stations do not include merchants of aviation or other non-automotive fuels.'
75
+ - rule: gas-ev-charging
76
+ url: https://www.verizon.com/support/verizon-visa-card-rewards-legal/
77
+ quote: 'a merchant of parking lots, parking meters or parking garages may have an MCC identification'
78
+ - rule: grocery-stores
79
+ url: https://www.verizon.com/support/verizon-visa-card-rewards-legal/
80
+ quote: 'Grocery purchases include purchases made at grocery stores and supermarkets.'
81
+ - rule: grocery-stores
82
+ url: https://www.verizon.com/support/verizon-visa-card-rewards-legal/
83
+ quote: 'grocery purchases at Walmart, Target or other "big box" retailers may not qualify'
84
+ - rule: restaurants
85
+ url: https://www.verizon.com/support/verizon-visa-card-rewards-legal/
86
+ quote: '4% in Verizon Dollars for every Net New Purchase made at restaurants.'
87
+ - rule: restaurants
88
+ url: https://www.verizon.com/financial-services/verizon-visa-card/
89
+ quote: '4% on restaurant purchases, including take-out and delivery'
90
+ - rule: caterers
91
+ url: https://www.verizon.com/support/verizon-visa-card-rewards-legal/
92
+ quote: 'Restaurants are generally identified as restaurants, drinking places, fast food places and caterers.'
93
+ - rule: verizon-purchases
94
+ url: https://www.verizon.com/support/verizon-visa-card-rewards-legal/
95
+ quote: 'Net New Purchase made at a Verizon operated store, Verizon online, over the phone with a Verizon representative'
96
+ - rule: verizon-purchases
97
+ url: https://www.verizon.com/support/verizon-visa-card-rewards-legal/
98
+ quote: 'Verizon purchases include purchases of devices and accessories but do not include the payment'
99
+ - rule: verizon-purchases
100
+ url: https://www.verizon.com/support/verizon-visa-card-rewards-legal/
101
+ quote: 'including any "big box" retailers such as Walmart or Best Buy that offer Verizon services.'
102
+ - rule: annual_fee
103
+ url: https://www.verizon.com/support/verizon-visa-card-faqs/
104
+ quote: 'No annual fee and foreign transaction fees.'
105
+ - rule: foreign_transaction_fee
106
+ url: https://www.verizon.com/support/verizon-visa-card-faqs/
107
+ quote: 'No annual fee and foreign transaction fees.'
108
+ - rule: requires_membership
109
+ url: https://www.verizon.com/support/verizon-visa-card-rewards-legal/
110
+ quote: 'In order to apply for a Credit Card Account, you must be either a Verizon Account Owner'
111
+ - rule: requires_membership
112
+ url: https://www.verizon.com/support/verizon-visa-card-faqs/
113
+ quote: 'Verizon wireless Business accounts and Prepaid accounts aren’t eligible to apply for the Verizon Visa Card.'
114
+ - rule: requires_membership
115
+ url: https://www.verizon.com/support/verizon-visa-card-faqs/
116
+ quote: 'you won’t continue to earn rewards, discounts, bonuses or Verizon Dollars'
117
+ - rule: welcome_offer
118
+ url: https://www.verizon.com/financial-services/verizon-visa-card/
119
+ quote: 'This offer is available for applicants who are approved between 8/12/26 and 1/13/27.'
120
+ - rule: welcome_offer
121
+ url: https://www.verizon.com/financial-services/verizon-visa-card/
122
+ quote: 'make one purchase within 90 days to receive the $150 statement credit.'
@@ -1,5 +1,6 @@
1
1
  id: wells-fargo-active-cash
2
2
  name: Wells Fargo Active Cash Card
3
+ color: '#b8333a'
3
4
  issuer: wells-fargo
4
5
  network: visa
5
6
  currency: cash
@@ -0,0 +1,73 @@
1
+ id: wells-fargo-autograph-journey
2
+ name: Wells Fargo Autograph Journey Card
3
+ short_name: Autograph Journey
4
+ color: '#2b2b2b'
5
+ issuer: wells-fargo
6
+ network: visa
7
+ currency: WFR
8
+ last_verified: 2026-11-04
9
+ verified_by: claude
10
+ source_urls:
11
+ - https://creditcards.wellsfargo.com/autograph-journey-visa-credit-card/
12
+ - https://www.wellsfargo.com/credit-cards/autograph-journey-visa/terms/
13
+ base_rate: 1
14
+ annual_fee: 95
15
+ foreign_transaction_fee: 0
16
+ welcome_offer:
17
+ points: 60000
18
+ spend: 4000
19
+ months: 3
20
+ note: Offers may differ by marketing channel. Not available if you have the card or opened one in the last 48 months, even if it's closed.
21
+ rules:
22
+ - id: hotels
23
+ match: { categories: [travel.hotels] }
24
+ rate: 5
25
+ note: Merchants coded as hotels and motels.
26
+ - id: airlines
27
+ match: { categories: [travel.flights] }
28
+ rate: 4
29
+ note: Merchants coded as airlines and air carriers.
30
+ - id: restaurants
31
+ match: { categories: [dining] }
32
+ rate: 3
33
+ note: Restaurants, bars, fast food and caterers.
34
+ - id: other-travel
35
+ match: { categories: [travel] }
36
+ rate: 3
37
+ note: Car rentals, cruise lines, travel agencies, discount travel sites, timeshares and campgrounds.
38
+ # Not modeled: the $50 yearly statement credit after a $50 airline purchase.
39
+ # Issuer text backing each rule; `yarn check-sources` checks it weekly.
40
+ evidence:
41
+ - rule: base_rate
42
+ url: https://creditcards.wellsfargo.com/autograph-journey-visa-credit-card/
43
+ quote: '1 rewards point will be earned per $1 spent on other net purchases'
44
+ - rule: hotels
45
+ url: https://creditcards.wellsfargo.com/autograph-journey-visa-credit-card/
46
+ quote: 'Five rewards points (1 base point plus 4 bonus points) are earned per $1 spent'
47
+ - rule: hotels
48
+ url: https://creditcards.wellsfargo.com/autograph-journey-visa-credit-card/
49
+ quote: 'with retailers whose merchant category code is classified as hotel/motel'
50
+ - rule: airlines
51
+ url: https://creditcards.wellsfargo.com/autograph-journey-visa-credit-card/
52
+ quote: 'Airlines: 4 points (1 base point plus 3 bonus points) for every $1 spent'
53
+ - rule: restaurants
54
+ url: https://creditcards.wellsfargo.com/autograph-journey-visa-credit-card/
55
+ quote: 'eating places and restaurants, drinking places, fast food restaurants, and caterers'
56
+ - rule: other-travel
57
+ url: https://creditcards.wellsfargo.com/autograph-journey-visa-credit-card/
58
+ quote: 'timeshare, or vehicle/auto rental, cruise lines, travel agencies, discount travel sites, campgrounds'
59
+ - rule: annual_fee
60
+ url: https://www.wellsfargo.com/credit-cards/autograph-journey-visa/terms/
61
+ quote: 'Annual Fee $95'
62
+ - rule: welcome_offer
63
+ url: https://creditcards.wellsfargo.com/autograph-journey-visa-credit-card/
64
+ quote: 'when you spend $4,000 in purchases in the first 3 months'
65
+ - rule: welcome_offer
66
+ url: https://creditcards.wellsfargo.com/autograph-journey-visa-credit-card/
67
+ quote: 'Earn 60,000 bonus points'
68
+ - rule: welcome_offer
69
+ url: https://creditcards.wellsfargo.com/autograph-journey-visa-credit-card/
70
+ quote: 'or opened one within the last 48 months from the date of the application'
71
+ - rule: foreign_transaction_fee
72
+ url: https://www.wellsfargo.com/credit-cards/autograph-journey-visa/terms/
73
+ quote: 'Foreign Transaction None'
@@ -1,5 +1,6 @@
1
1
  id: wells-fargo-autograph
2
2
  name: Wells Fargo Autograph Card
3
+ color: '#7d2130'
3
4
  issuer: wells-fargo
4
5
  network: visa
5
6
  currency: WFR
@@ -26,7 +26,9 @@
26
26
  mccs: [5814]
27
27
 
28
28
  - id: grocery
29
- name: Grocery
29
+ name: Grocery stores
30
+ # Keeps /best/grocery, the page's address before it had this name.
31
+ slug: grocery
30
32
  - id: grocery.supermarket
31
33
  name: Supermarkets
32
34
  aliases: [groceries, grocery, grocery stores, supermarket]
@@ -33,6 +33,45 @@
33
33
  - https://www.sofi.com/credit-card/unlimited/
34
34
  - https://www.sofi.com/card/rewards?cardtype=c
35
35
 
36
+ - id: bofa-travel-rewards
37
+ name: Bank of America Travel Rewards points
38
+ value_cents: 1.0
39
+ redemptions:
40
+ cash: 0.6
41
+ redemption_names:
42
+ cash: as cash
43
+ note: Each point is worth 1¢ as a statement credit against travel and dining purchases from the past 12 months, or 0.6¢ redeemed for cash.
44
+ sources:
45
+ - https://www.bankofamerica.com/credit-cards/terms-and-conditions/?campaignid=4079333&productoffercode=75&locale=en_US
46
+
47
+ - id: bofa-premium-rewards
48
+ name: Bank of America Premium Rewards points
49
+ value_cents: 1.0
50
+ note: Each point is worth 1¢ redeemed for cash, a statement credit or travel at the Travel Center.
51
+ sources:
52
+ - https://www.bankofamerica.com/credit-cards/terms-and-conditions/?campaignid=4079485&productoffercode=UN&locale=en_US
53
+
54
+ - id: usbank-altitude
55
+ name: U.S. Bank Altitude points
56
+ value_cents: 1.0
57
+ note: U.S. Bank values 20,000 Altitude Go points at $200 as a deposit to a U.S. Bank account (1¢ a point). Points also redeem as a statement credit, or for travel, gift cards and merchandise.
58
+ sources:
59
+ - https://www.usbank.com/credit-cards/altitude-go-visa-signature-credit-card.html
60
+
61
+ - id: navy-federal-rewards
62
+ name: Navy Federal Rewards points
63
+ value_cents: 1.0
64
+ note: Each point is worth 1¢ redeemed for cash (20,000 points is "a $200 value", per Navy Federal). Points also go to gift cards, merchandise and travel through the Navy Federal Rewards Center.
65
+ sources:
66
+ - https://www.navyfederal.org/loans-cards/credit-cards/more-rewards.html
67
+
68
+ - id: rei-rewards
69
+ name: REI Co-op Mastercard rewards
70
+ value_cents: 1.0
71
+ note: Dollars to spend at REI stores, REI.com, REI Outlet and the REI app, as Total REI Rewards. They can't be taken as cash or a check, and don't expire while the account is open.
72
+ sources:
73
+ - https://www.capitalone.com/credit-cards/rei/
74
+
36
75
  - id: best-buy-rewards
37
76
  name: My Best Buy rewards
38
77
  value_cents: 2.0
@@ -123,6 +162,15 @@
123
162
  sources:
124
163
  - https://thepointsguy.com/loyalty-programs/monthly-valuations/
125
164
 
165
+ - id: trueblue-points
166
+ name: JetBlue TrueBlue points
167
+ value_cents: 1.0
168
+ range: [1.0, 1.35]
169
+ note: JetBlue publishes no fixed cash value; award prices track the published base fare, and the Barclays Points Payback rate is shown only at redemption. 1.0¢ is a conservative default. 1.35¢ is TPG's November 2026 valuation.
170
+ sources:
171
+ - https://cards.barclaycardus.com/banking/cards/jetblue-plus-card/
172
+ - https://thepointsguy.com/loyalty-programs/monthly-valuations/
173
+
126
174
  - id: ihg-points
127
175
  name: IHG One Rewards points
128
176
  value_cents: 0.5
package/data/issuers.yaml CHANGED
@@ -1,35 +1,78 @@
1
1
  # The banks behind the cards: the name shown for each, and other words people
2
- # search with ("bofa", "amex"). Every card's `issuer` must be one of these.
2
+ # search with ("bofa", "amex"), and a color for drawing a card that has none
3
+ # of its own. Every card's `issuer` must be one of these.
3
4
 
4
5
  - id: amex
5
6
  name: American Express
7
+ color: '#2a6db0'
6
8
  search: [amex, american express]
7
9
  - id: bank-of-america
8
10
  name: Bank of America
11
+ color: '#b5122b'
9
12
  search: [bofa, boa, bankofamerica]
13
+ - id: barclays
14
+ name: Barclays
15
+ color: '#00395d'
16
+ search: [barclaycard, barclays us]
10
17
  - id: capital-one
11
18
  name: Capital One
19
+ color: '#1d3c6e'
12
20
  search: [capitalone]
21
+ - id: caltech-efcu
22
+ name: Caltech Employees Federal Credit Union
23
+ color: '#ff6c0c'
24
+ search: [cefcu, caltech efcu, caltech credit union]
13
25
  - id: chase
14
26
  name: Chase
27
+ color: '#1f4f9c'
15
28
  - id: citi
16
29
  name: Citi
30
+ color: '#3b4f66'
17
31
  search: [citibank]
18
32
  - id: column
19
33
  # Column N.A. issues the Bilt card; people know it as Bilt.
20
34
  name: Bilt
35
+ color: '#1a1a1a'
21
36
  search: [bilt]
22
37
  - id: discover
23
38
  name: Discover
39
+ color: '#e8751a'
24
40
  search: [discover it]
41
+ - id: elan
42
+ # Elan Financial Services issues the Fidelity Rewards Visa Signature.
43
+ name: Elan Financial Services
44
+ color: '#1d3f6e'
45
+ search: [elan, elan financial]
46
+ - id: goldman-sachs
47
+ # Goldman Sachs Bank USA issues the Apple Card.
48
+ name: Goldman Sachs
49
+ color: '#6b8fbf'
50
+ search: [goldman, gs]
51
+ - id: navy-federal
52
+ name: Navy Federal Credit Union
53
+ color: '#1b3a6b'
54
+ search: [nfcu, navy federal, navy fed]
55
+ - id: penfed
56
+ name: PenFed Credit Union
57
+ color: '#1f5c99'
58
+ search: [penfed, pentagon federal]
25
59
  - id: sofi
26
60
  name: SoFi
61
+ color: '#2d2f36'
62
+ - id: synchrony
63
+ # Synchrony Bank issues the PayPal Cashback Mastercard.
64
+ name: Synchrony
65
+ color: '#3b3f46'
66
+ search: [syf, synchrony bank]
27
67
  - id: td-bank
28
68
  name: TD Bank
69
+ color: '#2f6b3a'
29
70
  search: [td]
30
71
  - id: usbank
31
72
  name: U.S. Bank
73
+ color: '#3c4655'
32
74
  search: [us bank]
33
75
  - id: wells-fargo
34
76
  name: Wells Fargo
77
+ color: '#b8333a'
35
78
  search: [wf, wellsfargo]