earnrate 0.2.10 → 0.2.11

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 (41) hide show
  1. package/README.md +14 -6
  2. package/data/CHANGELOG.md +44 -0
  3. package/data/VERSION +1 -1
  4. package/data/cards/amex-delta-skymiles-gold.yaml +120 -0
  5. package/data/cards/amex-delta-skymiles-platinum.yaml +118 -0
  6. package/data/cards/amex-delta-skymiles-reserve.yaml +80 -0
  7. package/data/cards/amex-hilton-honors-aspire.yaml +140 -0
  8. package/data/cards/amex-hilton-honors-surpass.yaml +151 -0
  9. package/data/cards/amex-hilton-honors.yaml +117 -0
  10. package/data/cards/amex-marriott-bonvoy-bevy.yaml +116 -0
  11. package/data/cards/amex-marriott-bonvoy-brilliant.yaml +91 -0
  12. package/data/cards/amex-platinum.yaml +14 -0
  13. package/data/cards/bank-of-america-atmos-rewards-ascent.yaml +13 -0
  14. package/data/cards/bank-of-america-atmos-rewards-business.yaml +13 -0
  15. package/data/cards/bank-of-america-atmos-rewards-summit.yaml +16 -0
  16. package/data/cards/capital-one-quicksilver.yaml +80 -0
  17. package/data/cards/chase-aeroplan.yaml +28 -0
  18. package/data/cards/chase-marriott-bonvoy-bold.yaml +123 -0
  19. package/data/cards/chase-marriott-bonvoy-boundless.yaml +76 -0
  20. package/data/cards/chase-sapphire-reserve.yaml +29 -0
  21. package/data/cards/chase-united-business.yaml +10 -0
  22. package/data/cards/chase-united-club-business.yaml +19 -0
  23. package/data/cards/chase-united-club.yaml +31 -0
  24. package/data/cards/chase-united-explorer.yaml +19 -0
  25. package/data/cards/chase-united-gateway.yaml +18 -0
  26. package/data/cards/chase-united-quest.yaml +19 -0
  27. package/data/cards/citi-aadvantage-business.yaml +12 -1
  28. package/data/cards/citi-aadvantage-platinum-select.yaml +12 -1
  29. package/data/cards/discover-it-cash-back.yaml +169 -0
  30. package/data/currencies.yaml +26 -0
  31. package/data/issuers.yaml +3 -0
  32. package/data/merchants/overrides.yaml +16 -0
  33. package/data/merchants/seed.yaml +40 -0
  34. package/dist/engine/cheat-sheet.js +3 -0
  35. package/dist/engine/recommend.js +10 -8
  36. package/dist/mcp/prompts.js +90 -0
  37. package/dist/mcp/server.js +2 -0
  38. package/dist/mcp/tools/account.js +5 -4
  39. package/dist/mcp/tools/answers.js +7 -0
  40. package/dist/mcp/tools/wallet.js +1 -0
  41. package/package.json +1 -1
@@ -0,0 +1,151 @@
1
+ id: amex-hilton-honors-surpass
2
+ name: Hilton Honors American Express Surpass Card
3
+ issuer: amex
4
+ network: amex
5
+ currency: hilton-honors
6
+ last_verified: 2026-11-03
7
+ verified_by: claude
8
+ source_urls:
9
+ - https://www.americanexpress.com/us/credit-cards/card/hilton-honors-surpass/
10
+ - https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/hilton-honors-surpass-credit-card/25330-10-0#offer-terms
11
+ - https://www.americanexpress.com/us/content/rewards-info/retail.html
12
+ base_rate: 3
13
+ annual_fee: 150
14
+ foreign_transaction_fee: 0
15
+ welcome_offer:
16
+ points: 130000
17
+ spend: 3000
18
+ months: 6
19
+ valid_to: 2027-01-13
20
+ note: 'Plus one Free Night Reward (a standard room, expiring 12 months after it is issued), which earnrate does not value. Amex: "You may not be eligible to receive a welcome offer if you have or have had this Card, the Hilton Honors Amex Ascend Card or previous versions of these Cards," and may also decline based on your history with balance transfers, as a Card Member, and the number of cards you have opened and closed. Offers may vary between advertisements.'
21
+ rules:
22
+ - id: hilton-purchases
23
+ match: { merchants: [hilton] }
24
+ rate: 12
25
+ note: Charged directly with a hotel or resort in the Hilton portfolio. Bookings count only through a Hilton-operated reservation channel, not online travel sites; incidentals (hotel restaurants, spas) count when charged to the room and paid with the card at checkout.
26
+ - id: us-restaurants
27
+ match: { categories: [dining] }
28
+ exclude: { merchants: [dodger-stadium, bellagio], mccs: [5813] }
29
+ rate: 6
30
+ geography: us_only
31
+ note: U.S. restaurants, including takeout and delivery. Not restaurants abroad (even U.S.-owned chains), nightclubs or bars, and possibly not restaurants inside hotels, casinos or event venues.
32
+ - id: us-supermarkets
33
+ match: { categories: [grocery.supermarket] }
34
+ exclude: { categories: [superstore, warehouse_club, convenience_store] }
35
+ rate: 6
36
+ geography: us_only
37
+ note: Not superstores or warehouse clubs.
38
+ - id: us-gas
39
+ match: { categories: [gas] }
40
+ exclude: { categories: [gas.grocery_store, gas.superstore] }
41
+ rate: 6
42
+ geography: us_only
43
+ note: U.S. gas stations; not gas at superstores or warehouse clubs.
44
+ - id: us-online-retail
45
+ match:
46
+ categories:
47
+ [
48
+ online_retail,
49
+ superstore,
50
+ drugstore,
51
+ department_store,
52
+ clothing,
53
+ electronics,
54
+ sporting_goods,
55
+ home_improvement,
56
+ furniture,
57
+ ]
58
+ rate: 4
59
+ channel: online
60
+ geography: us_only
61
+ note: U.S. merchants selling physical goods, paid on their own website or app. Not restaurants, supermarkets, gas, car dealers, travel, entertainment or services. Online marketplaces with multiple retailers and third-party payment accounts don't count, nor do orders paid in store, in-store mobile wallet, phone or mail orders, or buy-now-pay-later. Amex's rewards-info page names Amazon.com and Walmart.com as online retailers, but these terms also exclude online marketplaces with multiple retailers, so Amazon Marketplace sellers may not earn 4x.
62
+ evidence:
63
+ - rule: base_rate
64
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/hilton-honors-surpass-credit-card/25330-10-0#offer-terms
65
+ quote: 'You will receive 3 Hilton Honors Bonus Points for each dollar of eligible purchases.'
66
+ - rule: hilton-purchases
67
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/hilton-honors-surpass-credit-card/25330-10-0#offer-terms
68
+ quote: 'for a total of 12, for each dollar of eligible purchases charged directly with a property within the Hilton portfolio'
69
+ - rule: hilton-purchases
70
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/hilton-honors-surpass-credit-card/25330-10-0#offer-terms
71
+ quote: 'the booking must be made directly through a reservation channel operated by Hilton'
72
+ - rule: us-restaurants
73
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/hilton-honors-surpass-credit-card/25330-10-0#offer-terms
74
+ quote: 'for a total of 6, for each dollar of eligible purchases at the following categories of merchants'
75
+ - rule: us-restaurants
76
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/hilton-honors-surpass-credit-card/25330-10-0#offer-terms
77
+ quote: 'excluding superstores and warehouse clubs: restaurants located in the U.S., supermarkets located in the U.S.'
78
+ - rule: us-restaurants
79
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/hilton-honors-surpass-credit-card/25330-10-0#offer-terms
80
+ quote: 'You will NOT get additional Points for purchases made at a restaurant owned by a U.S. company'
81
+ - rule: us-restaurants
82
+ url: https://www.americanexpress.com/us/content/rewards-info/retail.html
83
+ quote: 'You will NOT earn additional rewards at bars, nightclubs, convenience stores, supermarkets'
84
+ - rule: us-restaurants
85
+ url: https://www.americanexpress.com/us/credit-cards/card/hilton-honors-surpass/
86
+ quote: 'At U.S. restaurants, including takeout and delivery.'
87
+ - rule: us-supermarkets
88
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/hilton-honors-surpass-credit-card/25330-10-0#offer-terms
89
+ quote: 'supermarkets located in the U.S. and on gasoline at gas stations located in the U.S.'
90
+ - rule: us-gas
91
+ url: https://www.americanexpress.com/us/credit-cards/card/hilton-honors-surpass/
92
+ quote: 'Earn 6X Hilton Honors Bonus Points at U.S. restaurants, U.S. gas stations, and U.S. supermarkets.'
93
+ - rule: us-gas
94
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/hilton-honors-surpass-credit-card/25330-10-0#offer-terms
95
+ quote: 'excluding superstores and warehouse clubs'
96
+ - rule: us-online-retail
97
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/hilton-honors-surpass-credit-card/25330-10-0#offer-terms
98
+ quote: 'for a total of 4, for each dollar of eligible online retail purchases'
99
+ - rule: us-online-retail
100
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/hilton-honors-surpass-credit-card/25330-10-0#offer-terms
101
+ quote: 'from a U.S. retail merchant that sells physical goods or merchandise directly to consumers'
102
+ - rule: us-online-retail
103
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/hilton-honors-surpass-credit-card/25330-10-0#offer-terms
104
+ quote: 'Purchases made through a third-party payment account or on an online marketplace (with multiple retailers)'
105
+ - rule: us-online-retail
106
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/hilton-honors-surpass-credit-card/25330-10-0#offer-terms
107
+ quote: 'You will not receive additional Hilton Honors Bonus Points for purchases made online but paid for in store.'
108
+ - rule: annual_fee
109
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/hilton-honors-surpass-credit-card/25330-10-0#offer-terms
110
+ quote: 'Annual Fee $150 Transaction Fees'
111
+ - rule: foreign_transaction_fee
112
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/hilton-honors-surpass-credit-card/25330-10-0#offer-terms
113
+ quote: 'Foreign Transaction None Penalty Fees'
114
+ - rule: welcome_offer
115
+ url: https://www.americanexpress.com/us/credit-cards/card/hilton-honors-surpass/
116
+ quote: 'Earn 130,000 Hilton Honors Bonus Points + A Free Night Reward'
117
+ - rule: welcome_offer
118
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/hilton-honors-surpass-credit-card/25330-10-0#offer-terms
119
+ quote: 'after you spend $3,000 (the "Threshold Amount") on eligible purchases on your Card in your first 6 months'
120
+ - rule: welcome_offer
121
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/hilton-honors-surpass-credit-card/25330-10-0#offer-terms
122
+ quote: 'Offer ends 01/13/2027 at 23:59 MST.'
123
+ - rule: spend-15k
124
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/hilton-honors-surpass-credit-card/25330-10-0#offer-terms
125
+ quote: 'account reach $15,000 in a calendar year.'
126
+ - rule: spend-15k
127
+ url: https://www.americanexpress.com/us/credit-cards/card/hilton-honors-surpass/
128
+ quote: 'Earn a Free Night Reward from Hilton Honors after you spend $15,000 on eligible purchases'
129
+ - rule: spend-40k
130
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/hilton-honors-surpass-credit-card/25330-10-0#offer-terms
131
+ quote: 'You may receive an upgrade to Hilton Honors Diamond status if the total eligible purchases'
132
+ - rule: spend-40k
133
+ url: https://www.americanexpress.com/us/credit-cards/card/hilton-honors-surpass/
134
+ quote: 'after you spend $40,000 in eligible purchases on your Card in a calendar year.'
135
+ milestones:
136
+ - id: spend-15k
137
+ spend: 15000
138
+ period: calendar_year
139
+ rewards:
140
+ - Free Night Reward
141
+ note: Basic Card Member only, though Additional Card purchases count. A standard room for one night, expiring a year after it is issued. Amex says 8-12 weeks to arrive by email.
142
+ - id: spend-40k
143
+ spend: 40000
144
+ period: calendar_year
145
+ rewards:
146
+ - Hilton Honors Diamond status
147
+ note: Basic Card Member only, though Additional Card purchases count. Calendar year regardless of when the account opened. Diamond lasts through the end of the next calendar year.
148
+ todo:
149
+ - The $200 Hilton credit (up to $50 in statement credits each calendar quarter on purchases made directly with a Hilton property) isn't modeled.
150
+ - Complimentary Hilton Honors Gold status and National Car Rental Emerald Club Executive status (with enrollment) aren't modeled.
151
+ - The welcome offer's Free Night Reward isn't valued; a welcome offer holds only points.
@@ -0,0 +1,117 @@
1
+ id: amex-hilton-honors
2
+ name: Hilton Honors American Express Card
3
+ issuer: amex
4
+ network: amex
5
+ currency: hilton-honors
6
+ last_verified: 2026-11-03
7
+ verified_by: claude
8
+ source_urls:
9
+ - https://www.americanexpress.com/us/credit-cards/card/hilton-honors/
10
+ - https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/hilton-honors-credit-card/25330-10-0#offer-terms
11
+ - https://www.americanexpress.com/us/content/rewards-info/retail.html
12
+ base_rate: 3
13
+ annual_fee: 0
14
+ foreign_transaction_fee: 0
15
+ welcome_offer:
16
+ points: 70000
17
+ spend: 2000
18
+ months: 6
19
+ valid_to: 2027-01-13
20
+ note: 'Plus one Free Night Reward (a standard room, expiring 12 months after it is issued), which earnrate does not value. Amex: "You may not be eligible to receive a welcome offer if you have or have had this Card or previous versions of these Cards," and may also decline based on your history with balance transfers, as a Card Member, and the number of cards you have opened and closed. Offers may vary between advertisements.'
21
+ rules:
22
+ - id: hilton-purchases
23
+ match: { merchants: [hilton] }
24
+ rate: 7
25
+ note: Charged directly with a hotel or resort in the Hilton portfolio. Bookings count only through a Hilton-operated reservation channel, not online travel sites; incidentals (hotel restaurants, spas) count when charged to the room and paid with the card at checkout.
26
+ - id: us-restaurants
27
+ match: { categories: [dining] }
28
+ exclude: { merchants: [dodger-stadium, bellagio], mccs: [5813] }
29
+ rate: 5
30
+ geography: us_only
31
+ note: U.S. restaurants, including takeout and delivery. Not restaurants abroad (even U.S.-owned chains), nightclubs or bars, and possibly not restaurants inside hotels, casinos or event venues.
32
+ - id: us-supermarkets
33
+ match: { categories: [grocery.supermarket] }
34
+ exclude: { categories: [superstore, warehouse_club, convenience_store] }
35
+ rate: 5
36
+ geography: us_only
37
+ note: Groceries at superstores, warehouse clubs and convenience stores, and meal-kit delivery services, earn the 3x base rate.
38
+ - id: us-gas
39
+ match: { categories: [gas] }
40
+ exclude: { categories: [gas.grocery_store, gas.superstore] }
41
+ rate: 5
42
+ geography: us_only
43
+ note: Gas at supermarkets, superstores and warehouse clubs earns the 3x base rate.
44
+ milestones:
45
+ - id: spend-20k
46
+ spend: 20000
47
+ period: calendar_year
48
+ rewards:
49
+ - Hilton Honors Gold status
50
+ note: Basic Card Member only, though Additional Card purchases count. Calendar year regardless of when the account opened. Gold lasts through the end of the next calendar year. Amex says about 10-12 weeks to take effect.
51
+ evidence:
52
+ - rule: base_rate
53
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/hilton-honors-credit-card/25330-10-0#offer-terms
54
+ quote: 'You will receive 3 Hilton Honors Bonus Points for each dollar of eligible purchases.'
55
+ - rule: hilton-purchases
56
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/hilton-honors-credit-card/25330-10-0#offer-terms
57
+ quote: 'for a total of 7, for each dollar of eligible purchases charged directly with a property within the Hilton portfolio'
58
+ - rule: hilton-purchases
59
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/hilton-honors-credit-card/25330-10-0#offer-terms
60
+ quote: 'the booking must be made directly through a reservation channel operated by Hilton'
61
+ - rule: hilton-purchases
62
+ url: https://www.americanexpress.com/us/credit-cards/card/hilton-honors/
63
+ quote: 'Earn 7X Hilton Honors Bonus Points on eligible Hilton purchases'
64
+ - rule: us-restaurants
65
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/hilton-honors-credit-card/25330-10-0#offer-terms
66
+ quote: 'for a total of 5, for each dollar of eligible purchases at the following categories of merchants'
67
+ - rule: us-restaurants
68
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/hilton-honors-credit-card/25330-10-0#offer-terms
69
+ quote: 'restaurants located in the U.S., supermarkets located in the U.S.'
70
+ - rule: us-restaurants
71
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/hilton-honors-credit-card/25330-10-0#offer-terms
72
+ quote: 'You will NOT get additional Points for purchases made at a restaurant owned by a U.S. company'
73
+ - rule: us-restaurants
74
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/hilton-honors-credit-card/25330-10-0#offer-terms
75
+ quote: 'a restaurant located within another establishment (e.g. a restaurant inside a hotel, casino, or event venue)'
76
+ - rule: us-restaurants
77
+ url: https://www.americanexpress.com/us/content/rewards-info/retail.html
78
+ quote: 'You will NOT earn additional rewards at bars, nightclubs, convenience stores, supermarkets'
79
+ - rule: us-restaurants
80
+ url: https://www.americanexpress.com/us/credit-cards/card/hilton-honors/
81
+ quote: 'At U.S. restaurants, including takeout and delivery.'
82
+ - rule: us-supermarkets
83
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/hilton-honors-credit-card/25330-10-0#offer-terms
84
+ quote: 'supermarkets located in the U.S. and on gasoline at gas stations located in the U.S.'
85
+ - rule: us-supermarkets
86
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/hilton-honors-credit-card/25330-10-0#offer-terms
87
+ quote: 'purchases of groceries made at superstores, warehouse clubs, and convenience stores'
88
+ - rule: us-gas
89
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/hilton-honors-credit-card/25330-10-0#offer-terms
90
+ quote: 'Purchases of gasoline at supermarkets, superstores, and warehouse clubs will only get 3 Bonus Points per dollar.'
91
+ - rule: us-gas
92
+ url: https://www.americanexpress.com/us/credit-cards/card/hilton-honors/
93
+ quote: 'Earn 5X Hilton Honors Bonus Points at U.S. restaurants, U.S. gas stations, and U.S. supermarkets'
94
+ - rule: spend-20k
95
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/hilton-honors-credit-card/25330-10-0#offer-terms
96
+ quote: 'You may receive an upgrade to Hilton Honors Gold status if the total eligible purchases'
97
+ - rule: spend-20k
98
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/hilton-honors-credit-card/25330-10-0#offer-terms
99
+ quote: 'during a calendar year reach $20,000 or more.'
100
+ - rule: annual_fee
101
+ url: https://www.americanexpress.com/us/credit-cards/card/hilton-honors/
102
+ quote: 'There is no annual fee for the Hilton Honors American Express Card.'
103
+ - rule: foreign_transaction_fee
104
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/hilton-honors-credit-card/25330-10-0#offer-terms
105
+ quote: 'Foreign Transaction None Penalty Fees'
106
+ - rule: welcome_offer
107
+ url: https://www.americanexpress.com/us/credit-cards/card/hilton-honors/
108
+ quote: 'Earn 70,000 Hilton Honors Bonus Points + A Free Night Reward'
109
+ - rule: welcome_offer
110
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/hilton-honors-credit-card/25330-10-0#offer-terms
111
+ quote: 'after you spend $2,000 (the "Threshold Amount") on eligible purchases on your Card in your first 6 months'
112
+ - rule: welcome_offer
113
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/hilton-honors-credit-card/25330-10-0#offer-terms
114
+ quote: 'Offer ends 01/13/2027 at 11:59 PM MST.'
115
+ todo:
116
+ - Complimentary Hilton Honors Silver status (automatic with the card) isn't modeled.
117
+ - The welcome offer's Free Night Reward isn't valued; a welcome offer holds only points.
@@ -0,0 +1,116 @@
1
+ id: amex-marriott-bonvoy-bevy
2
+ name: Marriott Bonvoy Bevy American Express Card
3
+ issuer: amex
4
+ network: amex
5
+ currency: marriott-bonvoy
6
+ last_verified: 2026-11-03
7
+ verified_by: claude
8
+ source_urls:
9
+ - https://www.americanexpress.com/us/credit-cards/card/marriott-bonvoy-bevy/
10
+ - https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/marriott-bonvoy-bevy-card/25330-10-0#offer-terms
11
+ base_rate: 2
12
+ annual_fee: 250
13
+ foreign_transaction_fee: 0
14
+ welcome_offer:
15
+ points: 85000
16
+ spend: 5000
17
+ months: 6
18
+ not_with:
19
+ [
20
+ amex-marriott-bonvoy-brilliant,
21
+ chase-marriott-bonvoy-boundless,
22
+ chase-marriott-bonvoy-bold,
23
+ ]
24
+ note: 'No end date given. Not available if you have or have had this Card, the Marriott Bonvoy Brilliant Card or previous versions; Amex may also decline based on your card history. Also not available to anyone who had a Ritz-Carlton card from J.P. Morgan or a Marriott card from Chase (including Bountiful, Boundless and Bold) in the last 30 days, opened Bountiful, Boundless or Bold in the last 90 days, or got a new cardmember or upgrade bonus on one of those in the last 24 months.'
25
+ caps:
26
+ - {
27
+ id: dining-and-supermarkets,
28
+ amount: 15000,
29
+ period: calendar_year,
30
+ then_rate: 2,
31
+ }
32
+ rules:
33
+ - id: marriott-hotels
34
+ match: { merchants: [marriott] }
35
+ rate: 6
36
+ note: Charged directly with participating Marriott Bonvoy hotels, standalone Marriott retail stores and Marriott online stores (including Marriott gift cards online). Marriott's own member and elite points for stays aren't card earnings.
37
+ - id: restaurants
38
+ match: { categories: [dining] }
39
+ rate: 4
40
+ cap: dining-and-supermarkets
41
+ note: Restaurants worldwide, including takeout and delivery in the U.S., on the first $15,000 a calendar year combined with U.S. supermarkets. Not nightclubs or convenience stores; a restaurant inside a hotel, casino or event venue may code as that place instead.
42
+ - id: us-supermarkets
43
+ match: { categories: [grocery.supermarket] }
44
+ exclude: { categories: [superstore, warehouse_club, convenience_store] }
45
+ rate: 4
46
+ geography: us_only
47
+ cap: dining-and-supermarkets
48
+ note: On the first $15,000 a calendar year combined with restaurants. Superstores, convenience stores, warehouse clubs and meal-kit delivery services are not supermarkets.
49
+ milestones:
50
+ - id: free-night-15k
51
+ spend: 15000
52
+ period: calendar_year
53
+ rewards:
54
+ - Free Night Award (up to 50,000 points a night)
55
+ note: One a calendar year. Deposited 8-12 weeks after you reach the total; it expires a year after it's issued. Basic Card Member only.
56
+ evidence:
57
+ - rule: base_rate
58
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/marriott-bonvoy-bevy-card/25330-10-0#offer-terms
59
+ quote: 'You will receive 2 Marriott Bonvoy® points for each U.S. dollar of eligible purchases charged'
60
+ - rule: base_rate
61
+ url: https://www.americanexpress.com/us/credit-cards/card/marriott-bonvoy-bevy/
62
+ quote: '2X points on all other eligible purchases.'
63
+ - rule: marriott-hotels
64
+ url: https://www.americanexpress.com/us/credit-cards/card/marriott-bonvoy-bevy/
65
+ quote: '6X points at hotels participating in Marriott Bonvoy®'
66
+ - rule: marriott-hotels
67
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/marriott-bonvoy-bevy-card/25330-10-0#offer-terms
68
+ quote: 'when charged directly with participating Marriott Bonvoy properties, standalone Marriott branded retail establishments'
69
+ - rule: restaurants
70
+ url: https://www.americanexpress.com/us/credit-cards/card/marriott-bonvoy-bevy/
71
+ quote: '4X points at restaurants worldwide including takeout and delivery in the U.S. and U.S. Supermarkets'
72
+ - rule: restaurants
73
+ url: https://www.americanexpress.com/us/credit-cards/card/marriott-bonvoy-bevy/
74
+ quote: 'on up to $15,000 in combined purchases at restaurants and U.S. supermarkets per calendar year, then 2X points'
75
+ - rule: restaurants
76
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/marriott-bonvoy-bevy-card/25330-10-0#offer-terms
77
+ quote: 'You will NOT earn 2 additional points for purchases at nightclubs or convenience stores.'
78
+ - rule: us-supermarkets
79
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/marriott-bonvoy-bevy-card/25330-10-0#offer-terms
80
+ quote: 'for each dollar of eligible purchases charged at supermarkets located in the United States'
81
+ - rule: us-supermarkets
82
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/marriott-bonvoy-bevy-card/25330-10-0#offer-terms
83
+ quote: 'superstores, convenience stores, warehouse clubs, and meal-kit delivery services are not considered supermarkets'
84
+ - rule: us-supermarkets
85
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/marriott-bonvoy-bevy-card/25330-10-0#offer-terms
86
+ quote: 'Once you reach $15,000 in combined purchases at restaurants worldwide and U.S.'
87
+ - rule: free-night-15k
88
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/marriott-bonvoy-bevy-card/25330-10-0#offer-terms
89
+ quote: 'your total eligible purchases on your Marriott Bonvoy Bevy® American Express® Card reach $15,000'
90
+ - rule: free-night-15k
91
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/marriott-bonvoy-bevy-card/25330-10-0#offer-terms
92
+ quote: 'Limit one Free Night Award per calendar year.'
93
+ - rule: annual_fee
94
+ url: https://www.americanexpress.com/us/credit-cards/card/marriott-bonvoy-bevy/
95
+ quote: 'Annual Fee: $250'
96
+ - rule: annual_fee
97
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/marriott-bonvoy-bevy-card/25330-10-0#offer-terms
98
+ quote: 'Annual Fee $250 Transaction Fees'
99
+ - rule: foreign_transaction_fee
100
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/marriott-bonvoy-bevy-card/25330-10-0#offer-terms
101
+ quote: 'Foreign Transaction None Penalty Fees'
102
+ - rule: welcome_offer
103
+ url: https://www.americanexpress.com/us/credit-cards/card/marriott-bonvoy-bevy/
104
+ quote: 'Earn 85,000 Marriott Bonvoy® Bonus Points'
105
+ - rule: welcome_offer
106
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/marriott-bonvoy-bevy-card/25330-10-0#offer-terms
107
+ quote: 'eligible purchases on your Marriott Bonvoy Bevy® American Express® Card within your first 6 months of Card Membership'
108
+ - rule: not_with
109
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/marriott-bonvoy-bevy-card/25330-10-0#offer-terms
110
+ quote: 'if you have or have had this Card, the Marriott Bonvoy Brilliant® American Express® Card'
111
+ - rule: not_with
112
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/marriott-bonvoy-bevy-card/25330-10-0#offer-terms
113
+ quote: 'the Marriott Bonvoy Bold® Credit Card from Chase, the Marriott Bonvoy® Premier Plus Business Credit Card'
114
+ todo:
115
+ - 1,000 bonus points per paid eligible stay booked directly with Marriott is per stay, not per dollar, so it isn't modeled.
116
+ - Complimentary Gold Elite status and 15 Elite Night Credits each calendar year aren't modeled; they don't depend on spending.
@@ -0,0 +1,91 @@
1
+ id: amex-marriott-bonvoy-brilliant
2
+ name: Marriott Bonvoy Brilliant American Express Card
3
+ issuer: amex
4
+ network: amex
5
+ currency: marriott-bonvoy
6
+ last_verified: 2026-11-03
7
+ verified_by: claude
8
+ source_urls:
9
+ - https://www.americanexpress.com/us/credit-cards/card/marriott-bonvoy-brilliant/
10
+ - https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/marriott-bonvoy-brilliant-card/25330-10-0#offer-terms
11
+ base_rate: 2
12
+ annual_fee: 650
13
+ foreign_transaction_fee: 0
14
+ welcome_offer:
15
+ points: 100000
16
+ spend: 6000
17
+ months: 6
18
+ note: 'No end date given. Not available if you have or have had this Card, the Starwood Preferred Guest American Express Luxury Card or previous versions; Amex may also decline based on your card history. Also not available to anyone who had a Ritz-Carlton card from J.P. Morgan in the last 30 days, opened the Marriott Bonvoy Bountiful, Boundless or Bold card from Chase in the last 90 days, or got a new cardmember or upgrade bonus on one of those Chase cards in the last 24 months.'
19
+ rules:
20
+ - id: marriott-hotels
21
+ match: { merchants: [marriott] }
22
+ rate: 6
23
+ note: Charged directly with participating Marriott Bonvoy hotels, standalone Marriott retail stores and Marriott online stores (including Marriott gift cards online). Marriott's own member and elite points for stays aren't card earnings.
24
+ - id: restaurants
25
+ match: { categories: [dining] }
26
+ rate: 3
27
+ note: Restaurants worldwide. Not nightclubs, convenience stores, grocery stores or supermarkets; a restaurant inside a hotel, casino or event venue may code as that place instead.
28
+ - id: flights
29
+ match: { categories: [travel.flights] }
30
+ rate: 3
31
+ note: Scheduled flights charged directly with the airline. Charter and private jet flights are excluded.
32
+ milestones:
33
+ - id: earned-choice-60k
34
+ spend: 60000
35
+ period: calendar_year
36
+ rewards:
37
+ - 'Brilliant Earned Choice Award: pick five Nightly Upgrade Awards, a Free Night Award (up to 85,000 points) or 50,000 Bonvoy points'
38
+ note: One a calendar year, picked at choice-benefit.marriott.com/brilliant by February 1 of the next year, or it defaults to the Nightly Upgrade Awards. Basic Card Member only.
39
+ evidence:
40
+ - rule: base_rate
41
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/marriott-bonvoy-brilliant-card/25330-10-0#offer-terms
42
+ quote: 'You will receive 2 Marriott Bonvoy® points for each U.S. dollar of eligible purchases charged'
43
+ - rule: base_rate
44
+ url: https://www.americanexpress.com/us/credit-cards/card/marriott-bonvoy-brilliant/
45
+ quote: 'Spent on other eligible purchases.'
46
+ - rule: marriott-hotels
47
+ url: https://www.americanexpress.com/us/credit-cards/card/marriott-bonvoy-brilliant/
48
+ quote: '6X points at hotels participating in Marriott Bonvoy®'
49
+ - rule: marriott-hotels
50
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/marriott-bonvoy-brilliant-card/25330-10-0#offer-terms
51
+ quote: 'when charged directly with participating Marriott Bonvoy properties, standalone Marriott branded retail establishments'
52
+ - rule: restaurants
53
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/marriott-bonvoy-brilliant-card/25330-10-0#offer-terms
54
+ quote: '1 additional point (for a total of 3 points) for each dollar charged at restaurants worldwide'
55
+ - rule: restaurants
56
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/marriott-bonvoy-brilliant-card/25330-10-0#offer-terms
57
+ quote: 'You will NOT earn 1 additional point for purchases at nightclubs, convenience stores, grocery stores or supermarkets.'
58
+ - rule: flights
59
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/marriott-bonvoy-brilliant-card/25330-10-0#offer-terms
60
+ quote: 'for airfare on a scheduled flight charged directly with passenger airlines (charter flights and private jet flights are excluded)'
61
+ - rule: flights
62
+ url: https://www.americanexpress.com/us/credit-cards/card/marriott-bonvoy-brilliant/
63
+ quote: '3X points at restaurants worldwide & on flights booked directly with airlines'
64
+ - rule: earned-choice-60k
65
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/marriott-bonvoy-brilliant-card/25330-10-0#offer-terms
66
+ quote: 'your total eligible purchases on your Marriott Bonvoy Brilliant® American Express® Card reach or exceed $60,000'
67
+ - rule: earned-choice-60k
68
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/marriott-bonvoy-brilliant-card/25330-10-0#offer-terms
69
+ quote: 'Free Night Award with a redemption value up to 85K points• One-time deposit of 50K Marriott Bonvoy points'
70
+ - rule: earned-choice-60k
71
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/marriott-bonvoy-brilliant-card/25330-10-0#offer-terms
72
+ quote: 'only one Brilliant Earned Choice Award may be earned each calendar year per Card Account'
73
+ - rule: annual_fee
74
+ url: https://www.americanexpress.com/us/credit-cards/card/marriott-bonvoy-brilliant/
75
+ quote: 'Annual Fee: $650'
76
+ - rule: annual_fee
77
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/marriott-bonvoy-brilliant-card/25330-10-0#offer-terms
78
+ quote: 'Annual Fee $650 Transaction Fees'
79
+ - rule: foreign_transaction_fee
80
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/marriott-bonvoy-brilliant-card/25330-10-0#offer-terms
81
+ quote: 'Foreign Transaction None Penalty Fees'
82
+ - rule: welcome_offer
83
+ url: https://www.americanexpress.com/us/credit-cards/card/marriott-bonvoy-brilliant/
84
+ quote: 'Earn 100,000 Marriott Bonvoy® Bonus Points'
85
+ - rule: welcome_offer
86
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/marriott-bonvoy-brilliant-card/25330-10-0#offer-terms
87
+ quote: 'eligible purchases on your Marriott Bonvoy Brilliant® American Express® Card within your first 6 months of Card Membership'
88
+ todo:
89
+ - The Brilliant Earned Choice Award can be 50,000 points, but it's a pick among non-point awards too, so the milestone carries no points value.
90
+ - The $300 Brilliant Dining Credit (up to $25 a month at restaurants worldwide), the $100 property credit on two-night Ritz-Carlton or St. Regis stays, and the yearly Free Night Award (up to 85,000 points) after each renewal month aren't modeled.
91
+ - Complimentary Platinum Elite status and 25 Elite Night Credits each year aren't modeled; they don't depend on spending.
@@ -46,6 +46,14 @@ rules:
46
46
  match: { merchants: [amex-travel-cruises] }
47
47
  rate: 2
48
48
  note: Cruises booked and charged through AmexTravel.com or by phone with Amex Travel. Payments made directly to the cruise line don't count.
49
+ milestones:
50
+ - id: spend-75k
51
+ spend: 75000
52
+ period: calendar_year
53
+ rewards:
54
+ - Centurion Lounge guest access for 2 guests
55
+ - unlimited Delta Sky Club access
56
+ note: 'Purchases by additional card members count. Both last the rest of that calendar year, all of the next and through the January 31 after. Sky Club visits still need a same-day Delta flight.'
49
57
  # Issuer text backing each rule; `yarn check-sources` checks it weekly.
50
58
  evidence:
51
59
  - rule: base_rate
@@ -90,3 +98,9 @@ evidence:
90
98
  - rule: foreign_transaction_fee
91
99
  url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/platinum-card/25330-10-0#offer-terms
92
100
  quote: 'Foreign Transaction None Penalty Fees'
101
+ - rule: spend-75k
102
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/platinum-card/25330-10-0#offer-terms
103
+ quote: 'after spending $75,000 or more on eligible purchases on the Platinum Account in a calendar year'
104
+ - rule: spend-75k
105
+ url: https://www.americanexpress.com/en-us/credit-cards/apply/terms/personal/platinum-card/25330-10-0#offer-terms
106
+ quote: 'the total eligible purchases on the Eligible Platinum Card Account must equal or exceed $75,000'
@@ -42,6 +42,13 @@ rules:
42
42
  rate: 1.1
43
43
  requires: { membership: bank-of-america-account }
44
44
  note: The 1x base rate plus the 10% rewards bonus for holding an eligible Bank of America account.
45
+ milestones:
46
+ - id: spend-6k
47
+ spend: 6000
48
+ period: cardmember_year
49
+ rewards:
50
+ - a $99 Companion Fare
51
+ note: 'Spending by the account anniversary counts; the code arrives within 2 billing cycles after it. $99 plus taxes and fees from $23, for a companion on a Saver or Main Cabin fare within North America on Alaska or Hawaiian. Use it within 12 months.'
45
52
  evidence:
46
53
  - rule: base_rate
47
54
  url: https://www.bankofamerica.com/credit-cards/products/alaska-airlines-credit-card/
@@ -82,6 +89,12 @@ evidence:
82
89
  - rule: foreign_transaction_fee
83
90
  url: https://www.bankofamerica.com/credit-cards/terms-and-conditions/?campaignid=4081060&productoffercode=RS&locale=en_US
84
91
  quote: 'Foreign Transaction None Penalty Fee'
92
+ - rule: spend-6k
93
+ url: https://www.bankofamerica.com/credit-cards/products/alaska-airlines-credit-card/
94
+ quote: 'each account anniversary after you spend $6,000 or more on purchases within the prior anniversary year'
95
+ - rule: spend-6k
96
+ url: https://www.bankofamerica.com/credit-cards/terms-and-conditions/?campaignid=4081060&productoffercode=RS&locale=en_US
97
+ quote: 'each anniversary after spending $6,000 or more on Net Purchases'
85
98
  todo:
86
99
  - 20% back on Alaska and Hawaiian inflight purchases is a rebate, not points, and isn't modeled.
87
100
  - "BofA's rewards page lists Atmos Rewards cards as not eligible for the BofA Rewards tier bonus (in a popup the source check can't read), so the 10% account bonus stands alone."
@@ -43,6 +43,13 @@ rules:
43
43
  rate: 1.1
44
44
  requires: { membership: bank-of-america-small-business-account }
45
45
  note: The 1x base rate plus the 10% rewards bonus when the company has an eligible Bank of America small business account.
46
+ milestones:
47
+ - id: spend-6k
48
+ spend: 6000
49
+ period: cardmember_year
50
+ rewards:
51
+ - a $99 Companion Fare
52
+ note: 'Spending by the account anniversary counts; the code arrives within 2 billing cycles after it. $99 plus taxes and fees from $23, for a companion on a Saver or Main Cabin fare within North America on Alaska or Hawaiian. Use it within 12 months.'
46
53
  evidence:
47
54
  - rule: base_rate
48
55
  url: https://www.bankofamerica.com/smallbusiness/credit-cards/products/alaska-airlines-business-credit-card/
@@ -86,6 +93,12 @@ evidence:
86
93
  - rule: foreign_transaction_fee
87
94
  url: https://www.bankofamerica.com/smallbusiness/credit-cards/terms-and-conditions/?campaignid=4080500&productoffercode=CX&locale=en_US
88
95
  quote: 'International Transaction None Penalty Fee'
96
+ - rule: spend-6k
97
+ url: https://www.bankofamerica.com/smallbusiness/credit-cards/products/alaska-airlines-business-credit-card/
98
+ quote: 'every year that you spend at least $6,000 on purchases with your card'
99
+ - rule: spend-6k
100
+ url: https://www.bankofamerica.com/smallbusiness/credit-cards/terms-and-conditions/?campaignid=4080500&productoffercode=CX&locale=en_US
101
+ quote: 'after $6,000 or more in Net Purchases post to the account billing statement during the card anniversary year'
89
102
  todo:
90
103
  - 'annual_fee is the $70 per-company fee. Each card also costs $25 a year, which the schema has no field for.'
91
104
  - "BofA's rewards page lists Atmos Rewards cards as not eligible for the BofA Rewards tier bonus (in a popup the source check can't read), so the 10% account bonus stands alone."
@@ -50,6 +50,13 @@ rules:
50
50
  rate: 1.1
51
51
  requires: { membership: bank-of-america-account }
52
52
  note: The 1x base rate plus the 10% rewards bonus for holding an eligible Bank of America account.
53
+ milestones:
54
+ - id: spend-60k
55
+ spend: 60000
56
+ period: cardmember_year
57
+ rewards:
58
+ - a 100,000-point Global Companion Award
59
+ note: "Up to 100,000 points off a companion's award ticket when you book with points; it credits within 1-2 billing cycles and must be used within 12 months. Separate from the 25,000-point award every anniversary."
53
60
  evidence:
54
61
  - rule: base_rate
55
62
  url: https://www.bankofamerica.com/credit-cards/products/alaska-airlines-infinite-credit-card/
@@ -96,5 +103,14 @@ evidence:
96
103
  - rule: foreign_transaction_fee
97
104
  url: https://www.bankofamerica.com/credit-cards/terms-and-conditions/?campaignid=4081112&productoffercode=S2&locale=en_US
98
105
  quote: 'Foreign Transaction None Penalty Fee'
106
+ - rule: spend-60k
107
+ url: https://www.bankofamerica.com/credit-cards/products/alaska-airlines-infinite-credit-card/
108
+ quote: 'receive a 100,000-point Global Companion Award annually after spending $60,000 or more on purchases that year'
109
+ - rule: spend-60k
110
+ url: https://www.bankofamerica.com/credit-cards/terms-and-conditions/?campaignid=4081112&productoffercode=S2&locale=en_US
111
+ quote: 'Annual Global 100K Companion Award worth up to 100,000 points after you spend $60,000 or more'
112
+ - rule: spend-60k
113
+ url: https://www.bankofamerica.com/credit-cards/terms-and-conditions/?campaignid=4081112&productoffercode=S2&locale=en_US
114
+ quote: 'during your Card anniversary year (every 12 months from the open date anniversary)'
99
115
  todo:
100
116
  - "BofA's rewards page lists Atmos Rewards cards as not eligible for the BofA Rewards tier bonus (in a popup the source check can't read), so the 10% account bonus stands alone."