# Bonus Rewards

### Bonus Rewards

Spree gives brands the option to share revenue generated from the stablecoin reserves backing SP. The stablecoins sitting in vaults can be deployed into DeFi strategies. Brands that choose to participate can distribute a share of the generated revenue back to their users as bonus rewards.

This is not guaranteed for every partner or every user. Each brand decides whether to enable bonus rewards, which users qualify, and what conditions users must meet (holding a minimum balance, staking, completing actions, etc.).

### How It Works

1. **Brands opt in.** A brand chooses to distribute bonus rewards from the revenue generated by their SP reserves.
2. **Revenue accumulates.** Revenue from DeFi strategies accumulates over configurable time periods (epochs).
3. **Brands distribute.** The brand decides how to allocate accumulated revenue to qualifying users. Distribution is proportional to each user's average balance during the period.
4. **Users claim.** Qualifying users claim their bonus rewards. Batch claiming covers multiple periods in one transaction.

### Who Qualifies?

Brands configure the criteria. Common setups include:

* Minimum SP balance held during the period
* Staking or locking requirements
* Completion of specific actions or campaigns
* Tier-based eligibility (e.g., Gold and above)

### Key Points

* Bonus rewards are at the discretion of the issuing brand. There is no guaranteed return for holding SP.
* Each brand configures its own distribution rules, eligibility criteria, and payout schedule.
* Multiple brands can operate independent bonus reward programs within the same infrastructure.
* Per-brand revenue tracking supports attribution across coalition partners.

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) (BonusRewardsVault 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/bonus-rewards.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.
