> For the complete documentation index, see [llms.txt](https://docs.bloombot.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bloombot.app/manager/manager-pages/rewards.md).

# Rewards

Share your referral link, manage your code and payout address, claim rewards, and read your payout history.

## Where to Find It

Click **Rewards** in the header. On a phone, see [Mobile](https://docs.bloombot.app/manager/mobile.md).

<div align="left"><figure><img src="https://373591576-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMnkwltEDWRRlh7lLk05b%2Fuploads%2FjnV5TPjg4n2DpSCFv53q%2Frewards-page-overview.png?alt=media&amp;token=4c89154b-7e08-44be-b950-9178b09720ae" alt="Rewards page overview"><figcaption></figcaption></figure></div>

The **Rewards** button on the Wallets page is a different feature, see [Wallet Rewards](https://docs.bloombot.app/manager/manager-pages/wallets/wallet-rewards.md).

## One Chain at a Time

Pick the chain in the **Total Unclaimed Rewards** card. Amounts are in its native token, and earnings, claims and payout history are kept per chain.

## Referral Levels

Level 1 earns you 25% in rewards, Level 2 earns 3% and Level 3 earns 2%. Level 1 joined with your code, Level 2 with a Level 1 member's code, Level 3 the next level down.

The chips **L1**, **L2** and **L3** show each level's users and trading volume. Click the users or volume figure to split the bar by it.

<div align="left"><figure><img src="https://373591576-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMnkwltEDWRRlh7lLk05b%2Fuploads%2FuyqyfIzdDI9eQGeGfIjI%2Frewards-referral-levels-bar.png?alt=media&amp;token=3ea0c759-a438-401c-ae83-fd063ab4a2f3" alt="Referral levels bar split by users and volume"><figcaption></figcaption></figure></div>

## What the Figures Mean

| Figure                      | Description                                |
| --------------------------- | ------------------------------------------ |
| **Total Unclaimed Rewards** | Rewards not yet claimed.                   |
| **Lifetime earnings**       | Referral rewards plus cashback earnings.   |
| **Total claimed**           | Rewards already paid out to you.           |
| **Users referred**          | Users across all three levels.             |
| **Referrals volume**        | Trading volume of all three levels.        |
| **Cashback percentage**     | Your cashback rate.                        |
| **Cashback earnings**       | Cashback earned so far.                    |
| **Direct trades referred**  | Trades credited to you as direct referrer. |

## Payout History

The table lists your payouts by **Date**, **Amount**, **Status** and **Transaction**. **View in Block Explorer** opens a payout's transaction.

<div align="left"><figure><img src="https://373591576-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMnkwltEDWRRlh7lLk05b%2Fuploads%2FpAuWRi6jaZSC2z30ED5o%2Frewards-payout-history-table.png?alt=media&amp;token=68c5b1d7-7c6c-488d-8af2-c14071c5ae02" alt="Payout history table with paging controls"><figcaption></figcaption></figure></div>

## How to Share Your Referral Link

Click your code or the link under it in the **Referral code** card to copy your link.

## How to Change Your Referral Code

{% stepper %}
{% step %}
Click **Edit Referral Code**.

<div align="left"><figure><img src="https://373591576-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMnkwltEDWRRlh7lLk05b%2Fuploads%2FOSuvRXRpjHVOvkqWfoiG%2Frewards-edit-referral-code-dialog.png?alt=media&amp;token=76e702af-b543-4e39-af9a-e349fb28b95c" alt="Edit Referral Code dialog"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Type a new code in **Referral code**. A code is 1 to 10 letters and numbers.
{% endstep %}

{% step %}
Click **Save Changes**.
{% endstep %}
{% endstepper %}

## How to Set Your Payout Address

Your referral rewards and cashback are paid to this address when you claim. It can be any wallet you control, not only a Bloom wallet.

{% stepper %}
{% step %}
Click **Set Payout Address**, or **Edit Payout Address** once an address exists.

<div align="left"><figure><img src="https://373591576-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMnkwltEDWRRlh7lLk05b%2Fuploads%2FsdXJz3x7jFiU3yHIpgbu%2Frewards-edit-payout-address-dialog.png?alt=media&amp;token=52b04291-7d9c-4720-b41c-446ab0989c06" alt="Edit Payout Address dialog"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Paste the address in **Payout address**.
{% endstep %}

{% step %}
Click **Save Changes**.
{% endstep %}
{% endstepper %}

## How to Claim

{% stepper %}
{% step %}
Pick the chain, then click **Claim Rewards**.
{% endstep %}

{% step %}
Check the payout address and click **Claim**.
{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.bloombot.app/manager/manager-pages/rewards.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
