> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jup.ag/llms.txt
> Use this file to discover all available pages before exploring further.

# Affiliate & Referrals

> How the Offerbook referral program works, vanity slugs, share URLs, and claiming rewards

Offerbook has a built-in referral program that lets users share protocol fees. When someone you refer interacts with Offerbook, a portion of the platform fee is redirected back to you (the referrer) and partially refunded to the referred user.

This page covers the user-facing affiliate experience: how to create your referral link, customize it with a vanity slug, share it, and claim your earned rewards. Referral rewards are a share of the protocol fees charged at each loan stage; the fee schedule itself is in [Fees & Costs](/user-docs/earn/offerbook/fees-and-costs).

<Note>
  The referral program applies at every stage where a fee is charged: loan start (25% fee paid by the borrower), repayment (10% fee paid by the lender), and collateral transfer (0.1% fee paid by the lender).
</Note>

***

## How It Works

<AccordionGroup>
  <Accordion title="Default fee split">
    Each protocol fee is split between three parties:

    | Recipient                  | Share          |
    | -------------------------- | -------------- |
    | **Referred user** (rebate) | 20% of the fee |
    | **Referrer**               | 30% of the fee |
    | **Protocol**               | 50% of the fee |

    The 20% rebate is always credited to whoever is paying the fee at that stage, and the 30% share goes to that user's referrer: the borrower (and their referrer) at loan start, the lender (and their referrer) at repayment and collateral transfer.
  </Accordion>

  <Accordion title="How referrals apply across a loan">
    Each stage is independent: only the referral relationship of the user paying the fee at that stage applies.

    | Stage                          | Who pays the fee | Rebate (20%) and referrer share (30%) follow |
    | ------------------------------ | ---------------- | -------------------------------------------- |
    | Loan start (25% fee)           | Borrower         | The borrower and their referrer              |
    | Repayment (10% fee)            | Lender           | The lender and their referrer                |
    | Collateral transfer (0.1% fee) | Lender           | The lender and their referrer                |

    **Example:** a lender (referred) is repaid on a loan, and the protocol charges \$10 in fees at repayment: the lender receives a \$2 rebate, the lender's referrer earns \$3, and the protocol retains \$5.
  </Accordion>

  <Accordion title="When does the referral take effect?">
    A referral is applied when a referred user opens Offerbook through your share link and accepts the referral. Once accepted, the referral persists for all future fee-generating actions of that user.

    If a saved referral code is no longer valid (for example, if the referrer changed their vanity slug — see [Vanity Slugs](#vanity-slugs)), it is cleared automatically. Users are not blocked from using Offerbook in the meantime.
  </Accordion>
</AccordionGroup>

***

## Your Affiliate Page

The **Affiliate** page (accessible from the header) shows your referral activity and lets you customize your share link. It is also available as an Affiliate tab on any profile you visit, scoped to that profile.

The page surfaces:

* Your share URL (with vanity slug if set, or a UUID fallback)
* A rewards claim table listing accrued referral earnings ready to claim
* Your overall affiliate stats (referrals, earnings)

***

## Vanity Slugs

By default, your share URL uses a UUID code that is unique but not memorable. You can replace it with a vanity slug — a custom, readable identifier — that you control.

<AccordionGroup>
  <Accordion title="Validation rules">
    Vanity slug validation accepts:

    * Letters (uppercase and lowercase)
    * Digits
    * Underscores (`_`)
    * Hyphens (`-`)

    Slugs must be unique across all Offerbook users.
  </Accordion>

  <Accordion title="Setting or changing your slug">
    Go to your Affiliate page and edit the slug field. Once saved, your share URL is updated to use the new slug.

    <Warning>
      Changing your slug invalidates the previous one. Anyone who saved the old link will no longer be attributed to you when they open it, and the old slug may be claimed by another user.
    </Warning>
  </Accordion>

  <Accordion title="Fallback to UUID">
    If you have not set a vanity slug, your share URL uses a UUID code automatically. The UUID still works, but is harder to share verbally or print.
  </Accordion>
</AccordionGroup>

***

## Sharing Your Link

Your share URL is shown on your Affiliate page. Send it through any channel you prefer (social media, direct message, etc.). Anyone who opens Offerbook through your link gets your referral applied.

***

## Claiming Rewards

Referral earnings accumulate in the rewards claim table on your Affiliate page. Each row shows an unclaimed reward; you can claim them individually or in batches depending on the interface.

Claiming is a standard onchain transaction signed from your wallet. There is no minimum claim threshold at the protocol level, but Solana transaction fees still apply.

<Note>
  Referral rewards are paid in the same asset as the fee they originated from (USDC for loan start and repayment fees; collateral asset for collateral transfer fees).
</Note>

***

## FAQ

<AccordionGroup>
  <Accordion title="Can I change my vanity slug after sharing it?">
    Yes, but doing so breaks the previous link. Anyone who opens the old link after the change is no longer attributed to you, and the old slug may be claimed by someone else. Pick a slug you intend to keep.
  </Accordion>

  <Accordion title="Are referral rewards taxable?">
    Treatment of crypto referral rewards varies by jurisdiction. Offerbook does not provide tax advice. Consult a qualified tax professional in your country.
  </Accordion>
</AccordionGroup>