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,94 @@
1
+ id: amex-gold
2
+ name: American Express Gold Card
3
+ issuer: amex
4
+ network: amex
5
+ currency: MR
6
+ last_verified: 2026-10-24
7
+ verified_by: collin
8
+ source_urls:
9
+ - https://www.americanexpress.com/us/credit-cards/card/gold-card/
10
+ - https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/gold-card/25330-10-0#offer-terms
11
+ base_rate: 1
12
+ annual_fee: 325
13
+ welcome_offer:
14
+ points: 100000
15
+ spend: 8000
16
+ months: 6
17
+ note: 'The public offer is "as high as" 100,000 points; Amex shows the exact amount (which may be lower, or no offer) after you apply and before you accept. Not available if you have or have had this Card, the Premier Rewards Gold Card, the Platinum Card (including the Schwab and Morgan Stanley versions) or previous versions of these Cards; Amex may also decline based on your card history.'
18
+ rules:
19
+ - id: restaurants
20
+ match: { categories: [dining] }
21
+ rate: 4
22
+ cap: { amount: 50000, period: calendar_year, then_rate: 1 }
23
+ exclude: { merchants: [dodger-stadium, bellagio], mccs: [5813] }
24
+ note: Worldwide. Not at restaurants inside hotels, casinos or event venues, or at bars, bakeries, cafeterias or caterers. Third-party delivery counts only in the U.S.
25
+ - id: us-supermarkets
26
+ match: { categories: [grocery.supermarket] }
27
+ exclude: { categories: [superstore, warehouse_club, convenience_store] }
28
+ rate: 4
29
+ geography: us_only
30
+ cap: { amount: 25000, period: calendar_year, then_rate: 1 }
31
+ note: Superstores, convenience stores, warehouse clubs and meal-kit delivery services are not supermarkets.
32
+ - id: flights
33
+ match: { categories: [travel.flights] }
34
+ rate: 3
35
+ note: Scheduled flights charged directly with the airline or through Amex Travel. Charter and private jet flights are excluded.
36
+ - id: flights-amex-travel
37
+ match: { merchants: [amex-travel-flights] }
38
+ rate: 3
39
+ - id: prepaid-hotels-amex-travel
40
+ match: { merchants: [amex-travel-hotels] }
41
+ rate: 5
42
+ note: Prepaid hotels only.
43
+ - id: prepaid-car-rental-amex-travel
44
+ match: { merchants: [amex-travel-car-rentals] }
45
+ rate: 2
46
+ note: Prepaid car rentals only.
47
+ - id: cruises-amex-travel
48
+ match: { merchants: [amex-travel-cruises] }
49
+ rate: 2
50
+ note: Booked and paid through AmexTravel.com.
51
+ - id: airbnb-amex-travel
52
+ match: { merchants: [airbnb-amex-travel] }
53
+ rate: 2
54
+ note: Prepaid Airbnb stays booked through Amex Travel. Add-on fees such as pet or pool fees don't count.
55
+ # Not modeled on purpose: the Venue Collection benefit (10% back at select
56
+ # stadiums and arenas, with enrollment) is a statement credit, not points.
57
+ # Issuer text backing each rule; `yarn check-sources` checks it weekly.
58
+ evidence:
59
+ - rule: base_rate
60
+ url: https://www.americanexpress.com/us/credit-cards/card/gold-card/
61
+ quote: 'Earn 1X Membership Rewards ® points on all other eligible purchases.'
62
+ - rule: restaurants
63
+ url: https://www.americanexpress.com/us/credit-cards/card/gold-card/
64
+ quote: '4X POINTS At Restaurants Worldwide, on up to $50K'
65
+ - rule: us-supermarkets
66
+ url: https://www.americanexpress.com/us/credit-cards/card/gold-card/
67
+ quote: '4X POINTS On Groceries At U.S. supermarkets, on up to $25K'
68
+ - rule: flights
69
+ url: https://www.americanexpress.com/us/credit-cards/card/gold-card/
70
+ quote: '3X POINTS On Flights Booked through AmexTravel.com or Amex Travel App™'
71
+ - rule: prepaid-hotels-amex-travel
72
+ url: https://www.americanexpress.com/us/credit-cards/card/gold-card/
73
+ quote: '5X Points per dollar spent on Prepaid Hotels booked through AmexTravel.com'
74
+ - rule: prepaid-car-rental-amex-travel
75
+ url: https://www.americanexpress.com/us/credit-cards/card/gold-card/
76
+ quote: '2X POINTS On Prepaid Car Rentals Booked through AmexTravel.com'
77
+ - rule: cruises-amex-travel
78
+ url: https://www.americanexpress.com/us/credit-cards/card/gold-card/
79
+ quote: 'and cruises booked and paid through AmexTravel.com'
80
+ - rule: airbnb-amex-travel
81
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/gold-card/25330-10-0#offer-terms
82
+ quote: 'prepaid short-term rental bookings with Airbnb when made through AmexTravel.com'
83
+ - rule: flights-amex-travel
84
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/gold-card/25330-10-0#offer-terms
85
+ quote: 'airfare charged directly through American Express Travel'
86
+ - rule: annual_fee
87
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/gold-card/25330-10-0#offer-terms
88
+ quote: 'The annual fee for the American Express® Gold Card is $325.'
89
+ - rule: welcome_offer
90
+ url: https://www.americanexpress.com/us/credit-cards/card/gold-card/
91
+ quote: 'AS HIGH AS 100,000 Membership Rewards® points'
92
+ - rule: welcome_offer
93
+ url: https://www.americanexpress.com/us/credit-cards/card/gold-card/
94
+ quote: 'after you spend $8,000 in purchases on your new Card within the first 6 months'
@@ -0,0 +1,71 @@
1
+ id: amex-platinum
2
+ name: The Platinum Card from American Express
3
+ issuer: amex
4
+ network: amex
5
+ currency: MR
6
+ last_verified: 2026-10-24
7
+ verified_by: collin
8
+ source_urls:
9
+ - https://www.americanexpress.com/us/credit-cards/card/platinum/
10
+ - https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/platinum-card/25330-10-0#offer-terms
11
+ base_rate: 1
12
+ annual_fee: 895
13
+ welcome_offer:
14
+ points: 175000
15
+ spend: 12000
16
+ months: 6
17
+ note: 'The public offer is "as high as" 175,000 points; Amex shows the exact amount (which may be lower, or no offer) after you apply and before you accept. Not available if you have or have had this Card, the Schwab or Morgan Stanley Platinum Card, or previous versions of these Cards; Amex may also decline based on your card history.'
18
+ # One cap covers flights booked directly and through Amex Travel.
19
+ caps:
20
+ - { id: flights, amount: 500000, period: calendar_year, then_rate: 1 }
21
+ rules:
22
+ - id: flights
23
+ match: { categories: [travel.flights] }
24
+ rate: 5
25
+ cap: flights
26
+ note: Scheduled flights booked directly with the airline or through Amex Travel. Charter and private jet flights, and flights in tours, cruises or packages, are excluded.
27
+ - id: flights-amex-travel
28
+ match: { merchants: [amex-travel-flights] }
29
+ rate: 5
30
+ cap: flights
31
+ - id: prepaid-hotels-amex-travel
32
+ match: { merchants: [amex-travel-hotels] }
33
+ rate: 5
34
+ note: Prepaid hotels only.
35
+ - id: airbnb-amex-travel
36
+ match: { merchants: [airbnb-amex-travel] }
37
+ rate: 5
38
+ note: Prepaid Airbnb stays booked through Amex Travel, with your Airbnb account linked to Amex.
39
+ - id: cruises-amex-travel
40
+ match: { merchants: [amex-travel-cruises] }
41
+ rate: 2
42
+ note: Platinum's only 2x Amex Travel booking type.
43
+ # Issuer text backing each rule; `yarn check-sources` checks it weekly.
44
+ evidence:
45
+ - rule: base_rate
46
+ url: https://www.americanexpress.com/us/credit-cards/card/platinum/
47
+ quote: '1X POINTS On Other Purchases Terms and limitations apply.'
48
+ - rule: flights
49
+ url: https://www.americanexpress.com/us/credit-cards/card/platinum/
50
+ quote: '5X POINTS On Flights Booked directly with airlines or through'
51
+ - rule: prepaid-hotels-amex-travel
52
+ url: https://www.americanexpress.com/us/credit-cards/card/platinum/
53
+ quote: '5X POINTS On Prepaid Hotels Booked through American Express Travel ®'
54
+ - rule: airbnb-amex-travel
55
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/platinum-card/25330-10-0#offer-terms
56
+ quote: 'prepaid short-term rental reservations booked with Airbnb through AmexTravel.com'
57
+ - rule: cruises-amex-travel
58
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/platinum-card/25330-10-0#offer-terms
59
+ quote: 'only eligible for 1 additional point on cruise reservations'
60
+ - rule: flights-amex-travel
61
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/platinum-card/25330-10-0#offer-terms
62
+ quote: 'booked directly with passenger airlines or through American Express Travel'
63
+ - rule: annual_fee
64
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/platinum-card/25330-10-0#offer-terms
65
+ quote: 'The annual fee for the Platinum Card® is $895.'
66
+ - rule: welcome_offer
67
+ url: https://www.americanexpress.com/us/credit-cards/card/platinum/
68
+ quote: 'AS HIGH AS 175,000 Membership Rewards® points'
69
+ - rule: welcome_offer
70
+ url: https://www.americanexpress.com/us/credit-cards/card/platinum/
71
+ quote: 'after you spend $12,000 in purchases on your new Card within the first 6 months'
@@ -0,0 +1,71 @@
1
+ id: bank-of-america-atmos-rewards-ascent
2
+ name: Atmos Rewards Ascent Visa Signature Credit Card
3
+ issuer: bank-of-america
4
+ network: visa
5
+ currency: atmos-points
6
+ last_verified: 2026-10-26
7
+ verified_by: collin
8
+ source_urls:
9
+ - https://www.bankofamerica.com/credit-cards/products/alaska-airlines-credit-card/
10
+ base_rate: 1
11
+ annual_fee: 95
12
+ welcome_offer:
13
+ points: 50000
14
+ spend: 1500
15
+ months: 3
16
+ note: Limited-time online offer, no end date stated; it may not be available elsewhere after leaving the page. The window is 90 days from account opening. The offer also includes a $99 Companion Fare (plus taxes and fees from $23).
17
+ rules:
18
+ - id: alaska-and-hawaiian
19
+ match: { merchants: [alaska-airlines, hawaiian-airlines] }
20
+ rate: 3
21
+ note: Card points only; points and status from flying aren't card earnings.
22
+ - id: gas-ev-cable-streaming-transit
23
+ match: { categories: [gas, ev_charging, tv_internet, streaming, transit] }
24
+ rate: 2
25
+ note: Local transit includes rideshare. Bank of America says "cable"; internet-only or phone bills may not count.
26
+ - id: alaska-and-hawaiian-with-boa-account
27
+ match: { merchants: [alaska-airlines, hawaiian-airlines] }
28
+ rate: 3.3
29
+ requires: { membership: bank-of-america-account }
30
+ note: 3x plus the 10% rewards bonus for holding an eligible Bank of America account.
31
+ - id: gas-ev-cable-streaming-transit-with-boa-account
32
+ match: { categories: [gas, ev_charging, tv_internet, streaming, transit] }
33
+ rate: 2.2
34
+ requires: { membership: bank-of-america-account }
35
+ note: 2x plus the 10% rewards bonus for holding an eligible Bank of America account.
36
+ - id: everything-else-with-boa-account
37
+ match: { any: true }
38
+ rate: 1.1
39
+ requires: { membership: bank-of-america-account }
40
+ note: The 1x base rate plus the 10% rewards bonus for holding an eligible Bank of America account.
41
+ evidence:
42
+ - rule: base_rate
43
+ url: https://www.bankofamerica.com/credit-cards/products/alaska-airlines-credit-card/
44
+ quote: 'Earn unlimited 1 point for every $1 spent on all other purchases.'
45
+ - rule: alaska-and-hawaiian
46
+ url: https://www.bankofamerica.com/credit-cards/products/alaska-airlines-credit-card/
47
+ quote: 'Earn unlimited 3 points for every $1 spent on eligible Alaska Airlines and Hawaiian Airlines purchases.'
48
+ - rule: gas-ev-cable-streaming-transit
49
+ url: https://www.bankofamerica.com/credit-cards/products/alaska-airlines-credit-card/
50
+ quote: 'eligible gas, EV charging station, cable, streaming services and local transit purchases, including rideshare'
51
+ - rule: alaska-and-hawaiian-with-boa-account
52
+ url: https://www.bankofamerica.com/credit-cards/products/alaska-airlines-credit-card/
53
+ quote: '10% rewards bonus on all points earned from card purchases if you have an eligible Bank of America® account'
54
+ - rule: gas-ev-cable-streaming-transit-with-boa-account
55
+ url: https://www.bankofamerica.com/credit-cards/products/alaska-airlines-credit-card/
56
+ quote: "For example, for every 1,000 points you earn on purchases, you'll receive 1,100 points."
57
+ - rule: everything-else-with-boa-account
58
+ url: https://www.bankofamerica.com/credit-cards/products/alaska-airlines-credit-card/
59
+ quote: '10% rewards bonus on all points earned from card purchases if you have an eligible Bank of America® account'
60
+ - rule: annual_fee
61
+ url: https://www.bankofamerica.com/credit-cards/products/alaska-airlines-credit-card/
62
+ quote: '$95 annual fee'
63
+ - rule: welcome_offer
64
+ url: https://www.bankofamerica.com/credit-cards/products/alaska-airlines-credit-card/
65
+ quote: 'Get 50,000 bonus points and a $99 Companion Fare (plus taxes and fees from $23) with this offer.'
66
+ - rule: welcome_offer
67
+ url: https://www.bankofamerica.com/credit-cards/products/alaska-airlines-credit-card/
68
+ quote: 'spend $1,500 or more on purchases within the first 90 days of opening your account'
69
+ todo:
70
+ - 'The 10% rewards bonus rules use a proposed membership id, bank-of-america-account. Bank of America does not say on this page which accounts are "eligible".'
71
+ - 20% back on Alaska and Hawaiian inflight purchases is a rebate, not points, and isn't modeled.
@@ -0,0 +1,72 @@
1
+ id: bank-of-america-atmos-rewards-business
2
+ name: Atmos Rewards Visa Signature Business Card
3
+ issuer: bank-of-america
4
+ network: visa
5
+ currency: atmos-points
6
+ last_verified: 2026-10-26
7
+ verified_by: collin
8
+ source_urls:
9
+ - https://www.bankofamerica.com/smallbusiness/credit-cards/products/alaska-airlines-business-credit-card/
10
+ base_rate: 1
11
+ business: true
12
+ annual_fee: 70
13
+ welcome_offer:
14
+ points: 70000
15
+ spend: 4000
16
+ months: 3
17
+ note: Limited-time online offer, no end date stated. Online only; it may not be available after leaving the page, at a financial center or by phone. The window is 90 days from account opening. The offer also includes a $99 Companion Fare (plus taxes and fees from $23). The spend and window are in the offer's info tooltip, not the visible page text.
18
+ rules:
19
+ - id: alaska-and-hawaiian
20
+ match: { merchants: [alaska-airlines, hawaiian-airlines] }
21
+ rate: 3
22
+ note: Card points only; points and status from flying aren't card earnings.
23
+ - id: gas-ev-shipping-transit
24
+ match: { categories: [gas, ev_charging, shipping, transit] }
25
+ rate: 2
26
+ note: Local transit includes rideshare.
27
+ - id: alaska-and-hawaiian-with-boa-account
28
+ match: { merchants: [alaska-airlines, hawaiian-airlines] }
29
+ rate: 3.3
30
+ requires: { membership: bank-of-america-small-business-account }
31
+ note: 3x plus the 10% rewards bonus when the company has an eligible Bank of America small business account.
32
+ - id: gas-ev-shipping-transit-with-boa-account
33
+ match: { categories: [gas, ev_charging, shipping, transit] }
34
+ rate: 2.2
35
+ requires: { membership: bank-of-america-small-business-account }
36
+ note: 2x plus the 10% rewards bonus when the company has an eligible Bank of America small business account.
37
+ - id: everything-else-with-boa-account
38
+ match: { any: true }
39
+ rate: 1.1
40
+ requires: { membership: bank-of-america-small-business-account }
41
+ note: The 1x base rate plus the 10% rewards bonus when the company has an eligible Bank of America small business account.
42
+ evidence:
43
+ - rule: base_rate
44
+ url: https://www.bankofamerica.com/smallbusiness/credit-cards/products/alaska-airlines-business-credit-card/
45
+ quote: 'Earn 1 point for every $1 spent on all other purchases.'
46
+ - rule: alaska-and-hawaiian
47
+ url: https://www.bankofamerica.com/smallbusiness/credit-cards/products/alaska-airlines-business-credit-card/
48
+ quote: 'Earn 3 points for every $1 spent on eligible Alaska Airlines and Hawaiian Airlines purchases.'
49
+ - rule: gas-ev-shipping-transit
50
+ url: https://www.bankofamerica.com/smallbusiness/credit-cards/products/alaska-airlines-business-credit-card/
51
+ quote: 'eligible gas, EV charging station, shipping and local transit purchases, including rideshare'
52
+ - rule: alaska-and-hawaiian-with-boa-account
53
+ url: https://www.bankofamerica.com/smallbusiness/credit-cards/products/alaska-airlines-business-credit-card/
54
+ quote: 'earn a 10% rewards bonus on all points earned from card purchases'
55
+ - rule: gas-ev-shipping-transit-with-boa-account
56
+ url: https://www.bankofamerica.com/smallbusiness/credit-cards/products/alaska-airlines-business-credit-card/
57
+ quote: 'if your company has an eligible Bank of America® small business account.'
58
+ - rule: everything-else-with-boa-account
59
+ url: https://www.bankofamerica.com/smallbusiness/credit-cards/products/alaska-airlines-business-credit-card/
60
+ quote: 'if your company has an eligible Bank of America® small business account.'
61
+ - rule: annual_fee
62
+ url: https://www.bankofamerica.com/smallbusiness/credit-cards/products/alaska-airlines-business-credit-card/
63
+ quote: 'Plus, a low annual fee of $70 for the company and $25 per card.'
64
+ - rule: welcome_offer
65
+ url: https://www.bankofamerica.com/smallbusiness/credit-cards/products/alaska-airlines-business-credit-card/
66
+ quote: 'Limited-time online offer: 70,000 bonus points + $99 Companion Fare'
67
+ - rule: welcome_offer
68
+ url: https://www.bankofamerica.com/smallbusiness/credit-cards/products/alaska-airlines-business-credit-card/
69
+ quote: 'after you make $4,000 or more in purchases within the first 90 days of opening your account'
70
+ todo:
71
+ - 'The 10% rewards bonus rules use a proposed membership id, bank-of-america-small-business-account. Bank of America does not say on this page which accounts are "eligible".'
72
+ - 'annual_fee is the $70 per-company fee. Each card also costs $25 a year, which the schema has no field for.'
@@ -0,0 +1,70 @@
1
+ id: bank-of-america-atmos-rewards-summit
2
+ name: Atmos Rewards Summit Visa Infinite Credit Card
3
+ issuer: bank-of-america
4
+ network: visa
5
+ currency: atmos-points
6
+ last_verified: 2026-10-26
7
+ verified_by: collin
8
+ source_urls:
9
+ - https://www.bankofamerica.com/credit-cards/products/alaska-airlines-infinite-credit-card/
10
+ base_rate: 1
11
+ annual_fee: 395
12
+ welcome_offer:
13
+ points: 70000
14
+ spend: 3000
15
+ months: 3
16
+ note: Limited-time online offer, no end date stated; it may not be available elsewhere after leaving the page. The window is 90 days from account opening. The offer also includes a 25,000-point Global Companion Award.
17
+ rules:
18
+ - id: alaska-and-hawaiian
19
+ match: { merchants: [alaska-airlines, hawaiian-airlines] }
20
+ rate: 3
21
+ note: Card points only; points and status from flying aren't card earnings.
22
+ - id: dining
23
+ match: { categories: [dining] }
24
+ rate: 3
25
+ - id: alaska-and-hawaiian-with-boa-account
26
+ match: { merchants: [alaska-airlines, hawaiian-airlines] }
27
+ rate: 3.3
28
+ requires: { membership: bank-of-america-account }
29
+ note: 3x plus the 10% rewards bonus for holding an eligible Bank of America account.
30
+ - id: dining-with-boa-account
31
+ match: { categories: [dining] }
32
+ rate: 3.3
33
+ requires: { membership: bank-of-america-account }
34
+ note: 3x plus the 10% rewards bonus for holding an eligible Bank of America account.
35
+ - id: everything-else-with-boa-account
36
+ match: { any: true }
37
+ rate: 1.1
38
+ requires: { membership: bank-of-america-account }
39
+ note: The 1x base rate plus the 10% rewards bonus for holding an eligible Bank of America account.
40
+ evidence:
41
+ - rule: base_rate
42
+ url: https://www.bankofamerica.com/credit-cards/products/alaska-airlines-infinite-credit-card/
43
+ quote: 'Earn unlimited 1 point for every $1 spent on all other purchases.'
44
+ - rule: alaska-and-hawaiian
45
+ url: https://www.bankofamerica.com/credit-cards/products/alaska-airlines-infinite-credit-card/
46
+ quote: 'Earn 3 points for every $1 spent on eligible dining, foreign transaction, Alaska Airlines and Hawaiian Airlines purchases.'
47
+ - rule: dining
48
+ url: https://www.bankofamerica.com/credit-cards/products/alaska-airlines-infinite-credit-card/
49
+ quote: 'Earn 3 points for every $1 spent on eligible dining, foreign transaction, Alaska Airlines and Hawaiian Airlines purchases.'
50
+ - rule: alaska-and-hawaiian-with-boa-account
51
+ url: https://www.bankofamerica.com/credit-cards/products/alaska-airlines-infinite-credit-card/
52
+ quote: '10% rewards bonus on all points earned from card purchases if you have an eligible Bank of America® account'
53
+ - rule: dining-with-boa-account
54
+ url: https://www.bankofamerica.com/credit-cards/products/alaska-airlines-infinite-credit-card/
55
+ quote: "For example, for every 1,000 points you earn on purchases, you'll receive 1,100 points."
56
+ - rule: everything-else-with-boa-account
57
+ url: https://www.bankofamerica.com/credit-cards/products/alaska-airlines-infinite-credit-card/
58
+ quote: '10% rewards bonus on all points earned from card purchases if you have an eligible Bank of America® account'
59
+ - rule: annual_fee
60
+ url: https://www.bankofamerica.com/credit-cards/products/alaska-airlines-infinite-credit-card/
61
+ quote: '$395 annual fee and no foreign transaction fees'
62
+ - rule: welcome_offer
63
+ url: https://www.bankofamerica.com/credit-cards/products/alaska-airlines-infinite-credit-card/
64
+ quote: 'Earn 70,000 bonus points and a 25,000-point Global Companion Award after spending $3,000 or more on purchases'
65
+ - rule: welcome_offer
66
+ url: https://www.bankofamerica.com/credit-cards/products/alaska-airlines-infinite-credit-card/
67
+ quote: '$3,000 or more on purchases within the first 90 days of opening your account'
68
+ todo:
69
+ - '3x on "foreign transaction" purchases (anything charged in a foreign currency or processed abroad) is not modeled: rules have no foreign-only geography. It would make this card the pick for most purchases abroad.'
70
+ - 'The 10% rewards bonus rules use a proposed membership id, bank-of-america-account. Bank of America does not say on this page which accounts are "eligible".'
@@ -0,0 +1,91 @@
1
+ id: bilt-obsidian
2
+ name: Bilt Obsidian Card
3
+ # Issued by Column N.A. and serviced by Cardless; Bilt runs the rewards.
4
+ # Full earning terms: https://www.bilt.com/terms/bilt-card-offer-terms (PDF,
5
+ # not in source_urls because the source checker can't read PDFs).
6
+ issuer: column
7
+ network: mastercard # World Elite Mastercard
8
+ currency: BILT
9
+ last_verified: 2026-10-26
10
+ verified_by: collin
11
+ source_urls:
12
+ - https://www.bilt.com/card/obsidian
13
+ - https://www.bilt.com/card
14
+ base_rate: 1
15
+ annual_fee: 95
16
+ choices:
17
+ # Dining is the default. It can be switched once in the first 30 days, then
18
+ # only in January.
19
+ - id: three-x-category
20
+ pick: 1
21
+ period: calendar_year
22
+ default: [dining]
23
+ options:
24
+ dining: [dining]
25
+ grocery: [grocery.supermarket]
26
+ rules:
27
+ - id: bilt-travel-hotels
28
+ match: { merchants: [bilt-travel-hotels] }
29
+ rate: 4
30
+ note: 2X travel plus 2 Bilt Travel Portal bonus points, which post after the stay. No portal bonus if any part is paid with Bilt Points, Bilt Cash or travel credit.
31
+ - id: bilt-travel-flights
32
+ match: { merchants: [bilt-travel-flights] }
33
+ rate: 3
34
+ note: 2X travel plus 1 Bilt Travel Portal bonus point, which posts after the flight.
35
+ - id: dining
36
+ match: { choice: three-x-category, categories: [dining] }
37
+ rate: 3
38
+ note: When dining is the 3X pick (the default). Restaurants, bars, bakeries and fast food by Mastercard merchant code. Uncapped.
39
+ - id: grocery
40
+ match: { choice: three-x-category, categories: [grocery.supermarket] }
41
+ rate: 3
42
+ cap: { amount: 25000, period: calendar_year, then_rate: 1 }
43
+ note: When grocery is the 3X pick. Grocery stores and supermarkets by Mastercard merchant code; the $25,000 includes authorized users.
44
+ - id: lyft
45
+ match: { merchants: [lyft] }
46
+ rate: 3
47
+ requires: { activation: true }
48
+ note: 1X card earn plus 2X Bilt bonus after linking Bilt and Lyft accounts (matching phone numbers). Rides booked in the Lyft app only; bikes, scooters, Shared and Wait & Save rides, tips, taxes and fees don't earn the bonus.
49
+ - id: other-travel
50
+ match:
51
+ {
52
+ categories:
53
+ [travel.flights, travel.hotels, travel.cruise, travel.car_rental],
54
+ }
55
+ rate: 2
56
+ note: Booked directly with airlines, hotels, motels, resorts, cruise lines and car rental agencies, by Mastercard merchant code. Travel agencies and transit don't count.
57
+ # Not modeled on purpose: the $100 Bilt Travel Hotel credit and the $200 Bilt
58
+ # Cash welcome bonus.
59
+ todo:
60
+ - Rent and mortgage paid through Bilt earn 0X-1.25X depending on the cycle's everyday spend as a share of the housing payment (25%/50%/75%/100% tiers give 0.5X/0.75X/1X/1.25X; below 25% a flat 250 points). earnrate has no housing category or spend-ratio rule.
61
+ - The Flexible Bilt Cash option earns 4% Bilt Cash on everyday spend on top of points, but drops the housing multiplier (housing points must be bought with Bilt Cash, $3 per 100 points). Bilt Cash is a second currency; not modeled.
62
+ - Point Accelerator (spend $200 Bilt Cash for +1X on the next $5,000, up to five times a year) isn't modeled.
63
+ - Bilt Neighborhood Dining restaurants add a per-restaurant bonus (up to 6X total). It varies by restaurant, so it isn't modeled.
64
+ - Walgreens in-store (+1X, +2X on Walgreens-brand items, per the Bilt Rewards Points Earning Terms PDF at bilt.com/terms/earn), Metropolis parking, fitness classes and Bilt Home Delivery add Bilt bonuses not stated on an HTML page; not modeled.
65
+ - 'Welcome offer not modeled: the page offers $200 in Bilt Cash upon approval with no spend required. Bilt Cash is a second currency (not BILT points or cash), and this file already skips it on purpose.'
66
+ # Program text backing each rule; `yarn check-sources` checks it weekly.
67
+ evidence:
68
+ - rule: base_rate
69
+ url: https://www.bilt.com/card/obsidian
70
+ quote: 'Obsidian Card’s 1X everyday spend base rate'
71
+ - rule: bilt-travel-hotels
72
+ url: https://www.bilt.com/card/obsidian
73
+ quote: 'On hotels, that means 4X total from the base plus the portal bonus.'
74
+ - rule: bilt-travel-flights
75
+ url: https://www.bilt.com/card/obsidian
76
+ quote: 'delivers 3X total on flights booked through Bilt Travel'
77
+ - rule: dining
78
+ url: https://www.bilt.com/card/obsidian
79
+ quote: 'At account opening, dining is your default 3X category.'
80
+ - rule: grocery
81
+ url: https://www.bilt.com/card/obsidian
82
+ quote: 'If you choose grocery, the 3X rate applies up to $25,000 in grocery purchases per calendar year.'
83
+ - rule: lyft
84
+ url: https://www.bilt.com/card/obsidian
85
+ quote: 'you earn 3X total on Lyft'
86
+ - rule: other-travel
87
+ url: https://www.bilt.com/card/obsidian
88
+ quote: '3X on flights through Bilt Travel, 2X on other travel'
89
+ - rule: annual_fee
90
+ url: https://www.bilt.com/card/obsidian
91
+ quote: '$95 annual fee'
@@ -0,0 +1,33 @@
1
+ id: capital-one-kohls-card
2
+ name: Kohl's Credit Card
3
+ issuer: capital-one
4
+ network: store
5
+ only_at: [kohls]
6
+ currency: kohls-rewards
7
+ last_verified: 2026-10-26
8
+ verified_by: collin
9
+ source_urls:
10
+ - https://www.capitalone.com/credit-cards/kohls/
11
+ # Units are cents of Kohl's rewards per dollar, so 2.5 is 2.5%.
12
+ base_rate: 0
13
+ annual_fee: 0
14
+ rules:
15
+ - id: kohls
16
+ match: { merchants: [kohls] }
17
+ rate: 2.5
18
+ note: Card's own share only. Kohl's Rewards members earn 5% however they pay, and paying with the card raises that to 7.5% ("Earn 5% any way you pay or 7.5% when you use a Kohl's Card", kohls.com/feature/rewards.jsp, checked by hand because kohls.com blocks the weekly check). Kohl's stores and Kohls.com, excluding gift cards. Rewards turn into Kohl's Cash in $5 steps on the 1st of the next month and expire 30 days later.
19
+ todo:
20
+ - Capital One applies everyone for the Kohl's Rewards Visa first; this store-only card is the fallback.
21
+ - Periodic cardholder discounts aren't modeled. These are monthly savings offers, a yearly anniversary offer and a 40% off new-account coupon.
22
+ - MVC status ($600 a year at Kohl's on the card) adds free-shipping offers. Not modeled.
23
+ - "No fixed-amount welcome offer. New cardholders get a 40% off coupon for one transaction within 30 days of credit availability, a percentage discount, so it isn't modeled as welcome_offer."
24
+ evidence:
25
+ - rule: base_rate
26
+ url: https://www.capitalone.com/credit-cards/kohls/
27
+ quote: "Exclusively for use at Kohl's and Kohls.com"
28
+ - rule: kohls
29
+ url: https://www.capitalone.com/credit-cards/kohls/
30
+ quote: "you can shop at Kohl's to earn 7.5% in rewards on purchases"
31
+ - rule: annual_fee
32
+ url: https://www.capitalone.com/credit-cards/kohls/
33
+ quote: "when you open a Kohl's Card. No annual fee."
@@ -0,0 +1,48 @@
1
+ id: capital-one-kohls-rewards-visa
2
+ name: Kohl's Rewards Visa
3
+ issuer: capital-one
4
+ network: visa
5
+ currency: kohls-rewards
6
+ last_verified: 2026-10-26
7
+ verified_by: collin
8
+ source_urls:
9
+ - https://www.capitalone.com/credit-cards/kohls/
10
+ # Units are cents of Kohl's rewards per dollar, so 3 is 3%.
11
+ base_rate: 1
12
+ annual_fee: 0
13
+ rules:
14
+ - id: kohls
15
+ match: { merchants: [kohls] }
16
+ rate: 2.5
17
+ note: Card's own share only. Kohl's Rewards members earn 5% however they pay, and paying with the card raises that to 7.5% ("Earn 5% any way you pay or 7.5% when you use a Kohl's Card", kohls.com/feature/rewards.jsp, checked by hand because kohls.com blocks the weekly check). Kohl's stores and Kohls.com, excluding gift cards.
18
+ - id: gas
19
+ match: { categories: [gas] }
20
+ exclude: { categories: [gas.grocery_store, gas.superstore] }
21
+ rate: 3
22
+ note: Merchants whose main business is selling gasoline. Set by merchant category code.
23
+ - id: grocery-stores
24
+ match: { categories: [grocery.supermarket] }
25
+ exclude: { categories: [superstore, warehouse_club, convenience_store] }
26
+ rate: 2
27
+ note: Groceries at discount stores, superstores, warehouse clubs (e.g. Costco, Walmart) and convenience stores earn 1%.
28
+ todo:
29
+ - Earns only when the card is linked to a Kohl's Rewards account.
30
+ - Rewards turn into Kohl's Cash in $5 steps on the 1st of the next month and expire 30 days later. Kohl's Cash can't be used on Sephora at Kohl's.
31
+ - Periodic cardholder discounts aren't modeled. These are monthly savings offers, a yearly anniversary offer and a 40% off new-account coupon.
32
+ - "No fixed-amount welcome offer. New cardholders get a 40% off coupon for one transaction within 30 days of credit availability, a percentage discount, so it isn't modeled as welcome_offer."
33
+ evidence:
34
+ - rule: base_rate
35
+ url: https://www.capitalone.com/credit-cards/kohls/
36
+ quote: '1% on purchases everywhere else Visa is accepted.'
37
+ - rule: kohls
38
+ url: https://www.capitalone.com/credit-cards/kohls/
39
+ quote: '7.5% at Kohl’s stores or Kohls.com, excluding gift cards'
40
+ - rule: gas
41
+ url: https://www.capitalone.com/credit-cards/kohls/
42
+ quote: '3% on gasoline purchases made at merchants whose primary line of business is the sale of automotive gasoline'
43
+ - rule: grocery-stores
44
+ url: https://www.capitalone.com/credit-cards/kohls/
45
+ quote: '2% at grocery stores (grocery purchases made at discount stores or superstores, including warehouse clubs'
46
+ - rule: annual_fee
47
+ url: https://www.capitalone.com/credit-cards/kohls/
48
+ quote: "when you open a Kohl's Card. No annual fee."
@@ -0,0 +1,89 @@
1
+ id: capital-one-savor
2
+ name: Capital One Savor Rewards Credit Card
3
+ issuer: capitalone
4
+ # The card page never names the network in visible text; its embedded
5
+ # product data says MasterCard.
6
+ network: mastercard
7
+ currency: cash
8
+ last_verified: 2026-10-26
9
+ verified_by: collin
10
+ source_urls:
11
+ - https://www.capitalone.com/credit-cards/savor/
12
+ base_rate: 1
13
+ annual_fee: 0
14
+ welcome_offer:
15
+ dollars: 200
16
+ spend: 500
17
+ months: 3
18
+ note: One-time cash bonus, available by applying through the card page. Existing or previous cardmembers are not eligible if they received a new cardmember bonus for this product in the past 48 months.
19
+ rules:
20
+ - id: capital-one-entertainment
21
+ match: { merchants: [capital-one-entertainment] }
22
+ rate: 8
23
+ note: Tickets bought on the Capital One Entertainment ticketing platform only. Tickets bought directly from Capital One Hall or Capital One Arena are excluded.
24
+ - id: capital-one-travel-hotels-vacation-rentals-car-rentals
25
+ match:
26
+ {
27
+ merchants:
28
+ [
29
+ capital-one-travel-hotels,
30
+ capital-one-travel-vacation-rentals,
31
+ capital-one-travel-car-rentals,
32
+ ],
33
+ }
34
+ rate: 5
35
+ note: Only when booked through Capital One Travel. Flights booked there earn the base 1%.
36
+ - id: grocery-stores
37
+ match: { categories: [grocery.supermarket] }
38
+ exclude: { categories: [superstore], merchants: [walmart, target] }
39
+ rate: 3
40
+ note: Supermarkets, meat lockers, freezers, dairy product stores and specialty markets. Superstores like Walmart and Target are excluded.
41
+ - id: dining
42
+ match: { categories: [dining] }
43
+ rate: 3
44
+ note: Restaurants, cafes, bars, lounges, fast-food chains and bakeries. Restaurants inside hotels or grocery stores, and some food trucks, may not code as dining.
45
+ - id: entertainment
46
+ match: { categories: [entertainment, movie_theaters] }
47
+ rate: 3
48
+ note: Tickets at movie theaters, professional and semi-professional sports promoters, theatrical promoters, amusement parks, tourist attractions, aquariums, zoos, dance halls, record stores, pool halls and bowling alleys. Golf courses, collegiate sporting events, cable, streaming and membership services don't count as entertainment.
49
+ - id: streaming
50
+ match: { categories: [streaming] }
51
+ rate: 3
52
+ note: Only "popular streaming services"; Capital One doesn't list them on the card page.
53
+ todo:
54
+ - Online grocery and delivery (grocery.online, e.g. Instacart) isn't addressed on the card page. Only grocery.supermarket is modeled.
55
+ - Which streaming services are "popular" isn't listed on the card page.
56
+ - Amusement parks, tourist attractions, aquariums, zoos, record stores, pool halls and bowling alleys earn 3% as entertainment but have no earnrate category. Golf courses and collegiate sporting events are excluded but can't be told apart from the entertainment category.
57
+ - Capital One says purchases through third-party payment accounts, mobile card readers or digital wallets may not get the bonus rate. Not modeled.
58
+ # Issuer text backing each rule; `yarn check-sources` checks it weekly.
59
+ evidence:
60
+ - rule: base_rate
61
+ url: https://www.capitalone.com/credit-cards/savor/
62
+ quote: 'plus 1% cash back on all other purchases'
63
+ - rule: capital-one-entertainment
64
+ url: https://www.capitalone.com/credit-cards/savor/
65
+ quote: 'Earn unlimited 8% cash back on Capital One Entertainment purchases.'
66
+ - rule: capital-one-travel-hotels-vacation-rentals-car-rentals
67
+ url: https://www.capitalone.com/credit-cards/savor/
68
+ quote: 'Earn unlimited 5% cash back on hotels, vacation rentals and rental cars booked through Capital One Travel.'
69
+ - rule: grocery-stores
70
+ url: https://www.capitalone.com/credit-cards/savor/
71
+ quote: 'The 3% grocery earn is limited to purchases made at grocery stores'
72
+ - rule: grocery-stores
73
+ url: https://www.capitalone.com/credit-cards/savor/
74
+ quote: 'Superstores like Walmart and Target are excluded.'
75
+ - rule: dining
76
+ url: https://www.capitalone.com/credit-cards/savor/
77
+ quote: 'Purchases at restaurants, cafes, bars, lounges, fast-food chains and bakeries count as dining.'
78
+ - rule: entertainment
79
+ url: https://www.capitalone.com/credit-cards/savor/
80
+ quote: 'Ticket purchases made at movie theaters, sports promoters'
81
+ - rule: streaming
82
+ url: https://www.capitalone.com/credit-cards/savor/
83
+ quote: 'on dining, entertainment and popular streaming services, plus 1% cash back'
84
+ - rule: annual_fee
85
+ url: https://www.capitalone.com/credit-cards/savor/
86
+ quote: '$0 annual fee Plus, there are no hidden or foreign transaction fees.'
87
+ - rule: welcome_offer
88
+ url: https://www.capitalone.com/credit-cards/savor/
89
+ quote: 'Earn a one-time $200 cash bonus once you spend $500 on purchases within the first 3 months'