> For the complete documentation index, see [llms.txt](https://spree-finance.gitbook.io/spreefinance/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://spree-finance.gitbook.io/spreefinance/products/boost-engine.md).

# Boost Engine

### Reward Your Best Users More

The Boost Engine applies multipliers to campaign rewards based on each user's tier. A base-tier user earning 100 pSP gets 100 pSP. A top-tier user earning 100 pSP gets 250 pSP (or whatever multiplier the brand configured). Same campaign, same base reward, different outcomes based on loyalty commitment.

**The entire boost system operates on each brand's own token and tier configuration.** A brand issuing FLY Points with its own tier structure gets its own set of multipliers. Two brands on Spree can run entirely different boost configurations without affecting each other.

### Example Multipliers

These are example values. Brands configure their own multiplier per tier.

| Tier   | Example Multiplier | 100 pSP base reward becomes |
| ------ | ------------------ | --------------------------- |
| Tier 0 | 1.0x               | 100 pSP                     |
| Tier 1 | 1.25x              | 125 pSP                     |
| Tier 2 | 1.5x               | 150 pSP                     |
| Tier 3 | 2.0x               | 200 pSP                     |
| Tier 4 | 2.5x               | 250 pSP                     |

A DeFi protocol might use aggressive multipliers (1x to 5x). A ticketing company might use gentle ones (1x to 1.5x). Multipliers must increase with each tier level.

### Campaign-Specific Boosts

Each campaign can layer additional boosts on top of tier multipliers:

* **Early-bird bonus.** The first N users who claim get an extra multiplier. First 500 claimants earn +50% on top of their tier multiplier.
* **Loyalty bonus.** Extra boost for users with high activity or holding streaks.
* **Referral bonus.** Boost for users who brought referrals into the campaign.

The combined multiplier caps at 10x to prevent runaway payouts.

### Guardrails

* **Per-user caps.** Limit how many times a single user can receive boosted rewards in a campaign.
* **Cooldowns.** Set minimum time between boost applications for the same user.

These controls protect campaign budgets from concentrated extraction.

### How It Connects

The Boost Engine reads from the brand's own [Status & Tiers](https://github.com/Spree-Finance/spree-docs/blob/main/products/status-tiers/README.md) configuration. Campaigns distribute boosted Pending SP rewards at mint time. The multiplier applies and the boosted amount mints in a single transaction. The bonus comes from the campaign budget.

For technical integration details, see [SDK Reference](https://github.com/Spree-Finance/spree-docs/blob/main/developer-guides/stable-points-sp/sdk-reference/README.md) (BoostEngine wrapper).