# 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).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://spree-finance.gitbook.io/spreefinance/products/boost-engine.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.