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

# Referrals Program

> Invite friends, earn bonus points, and grow the ChameleonSwap community

## Overview

The ChameleonSwap Referrals Program lets you invite friends, reward their trading, and unlock extra benefits when you are a KOL (Ambassador). Referral codes are wallet-bound, can be customized, and weekly points and revenue share depend on invitee trading volume and KOL tier.

<Card title="Manage Your Referrals" icon="users" href="https://chameleonswap.xyz/referrals" target="_blank">
  Visit the Referrals page to generate your code, set a custom code, and view invitees.
</Card>

***

## How the Referral System Works

### Generating Your Referral Code

<Steps>
  <Step title="Reach minimum volume">
    Trade at least **1,000 USD** in total swap volume to unlock code generation.
  </Step>

  <Step title="Open Referrals / Points">
    Connect your wallet. When eligible, a generate button appears on the Referrals (or Points) page.
  </Step>

  <Step title="Generate your code">
    Click to create a unique code bound to your address. It works immediately after creation.
  </Step>

  <Step title="(Optional) set a custom code">
    Replace the original code with your own string. The previous code stops accepting claims; the new one is the only active code.
  </Step>
</Steps>

### Your Referral Code

Once generated you have:

* **Unique Code** – alphanumeric, bound to your address
* **Referral Link** – `https://chameleonswap.xyz/?ref=YOURCODE`
* **Custom code** – optional, easier to share; it replaces the old code

<Tip>
  After setting a custom code, share only the new code/link—the old code no longer accepts claims.
</Tip>

***

## Using a Referral Code

### How to Claim a Referral Code

<Steps>
  <Step title="Get a code or link">
    Receive a code from a friend or KOL, or open a link with `?ref=CODE`.
  </Step>

  <Step title="Connect your wallet">
    Go to [https://chameleonswap.xyz/](https://chameleonswap.xyz/) and connect your wallet.
  </Step>

  <Step title="Confirm the claim">
    On Referrals / Points, enter the code (or use the prefilled one) and confirm. After a successful claim the input disappears, and the inviter address plus bonus banner are shown.
  </Step>
</Steps>

### Important Rules

* **One claim per wallet:** claiming is permanent; you cannot switch later.
* **No self-referrals:** you cannot use your own code.
* **Custom code owner only:** only the owner can replace a code; the previous code stops working.
* **UI after claim:** the code field hides, inviter address is shown, and a 20% or 30% bonus banner appears (30% when the inviter is a KOL with the Ambassador label).

### Automatic Code Detection

Opening a link with `?ref=CODE` pre-fills the code in the app. You still confirm the claim manually.

***

## Managing Your Referrals

### Viewing Your Invitees

<CardGroup cols={2}>
  <Card title="Total Referred" icon="users">
    Number of addresses that claimed your code.
  </Card>

  <Card title="Invitees List" icon="list">
    Invitees with addresses and claim dates. KOLs are marked with the Ambassador label.
  </Card>
</CardGroup>

<Note>
  Invitee volume updates after their swaps are processed and may appear with a short delay.
</Note>

### Sharing Your Code

<AccordionGroup>
  <Accordion title="Copy Code">
    Copy the code and share it across X/Discord/Telegram/communities.
  </Accordion>

  <Accordion title="Copy Link">
    Copy the link with `?ref=` so the code is pre-filled on open.
  </Accordion>

  <Accordion title="Custom code">
    After setting a custom code, only the new code works—share that one.
  </Accordion>
</AccordionGroup>

***

## Earning Referral Bonuses

### How referral points are calculated

<Steps>
  <Step title="Volume tracking">
    Weekly USD volume of all invitees linked to your code is tracked.
  </Step>

  <Step title="Inviter bonus">
    You earn points proportional to invitee volume. If you are a KOL, the bonus is multiplied by your KOL tier.
  </Step>

  <Step title="Invitee bonus">
    Invitees get a weekly boost to their own points: **20%** standard or **30%** when the inviter is a KOL (shown via a banner).
  </Step>

  <Step title="Weekly distribution">
    Referral bonuses are added during the weekly points distribution and appear on the Points page.
  </Step>
</Steps>

### KOL (Ambassador) tiers and multipliers

* KOL status is address-bound and displayed as **Ambassador** in the UI.
* Weekly referral volume determines tier and multipliers:
  * **Tier 1:** 0–100k USD → **1.3×** referral points + **15%** revenue share
  * **Tier 2:** 100–200k USD → **1.4×** referral points + **30%** revenue share
  * **Tier 3:** 200k+ USD → **1.5×** referral points + **50%** revenue share
* Invitees referred by a KOL see the 30% bonus banner and the Ambassador label next to the inviter.

### Revenue share for KOLs

* Calculated weekly from KOL referral volume and tier (15/30/50%).
* Each week writes a separate revenue-share record; previous weeks are not overwritten.
* Revenue share accrues automatically alongside points—no user action needed.

***

## Eligibility Requirements

### To Generate a Referral Code

You must meet these requirements:

* ✅ **Minimum Trading Volume:** at least 1,000 USD total swap volume
* ✅ **Connected Wallet:** your wallet must be connected to ChameleonSwap
* ✅ **Active Account:** no account restrictions

### To Claim a Referral Code

Anyone can claim a referral code:

* ✅ No minimum volume required
* ✅ Just need a connected wallet
* ✅ One-time claim that cannot be changed later

<Note>
  Switching to a custom code does not change existing invitees; it only affects new claims.
</Note>

***

## Best Practices

<CardGroup cols={2}>
  <Card title="Share actively" icon="share">
    Share your current (or custom) code in the channels your community uses.
  </Card>

  <Card title="Provide value" icon="lightbulb">
    Help new users with their first swaps—their volume drives your bonus.
  </Card>

  <Card title="Track performance" icon="chart-line">
    Watch invitee volume on Referrals / Points, especially when targeting higher KOL tiers.
  </Card>

  <Card title="Build community" icon="users">
    Grow around your code; as a KOL you reach higher multipliers and revenue share faster.
  </Card>
</CardGroup>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="I can't generate a referral code">
    * Make sure you have at least 1,000 USD volume.
    * Confirm your wallet is connected.
    * Refresh if the button does not appear after eligibility is met.
  </Accordion>

  <Accordion title="I can't claim a referral code">
    * The wallet already claimed a code (one-time claim).
    * The code was replaced by a new custom code.
    * You are trying to use your own code.
  </Accordion>

  <Accordion title="My invitees aren't showing up">
    * Invitees have not confirmed the claim.
    * List and volume may appear with a short delay.
    * An old code was shared—provide the current custom code.
  </Accordion>

  <Accordion title="I'm not earning bonus points">
    * Invitees have not traded yet.
    * Bonuses post in the weekly distribution—wait for the next run.
    * If you are a KOL, check that your weekly referral volume reaches the next tier.
  </Accordion>
</AccordionGroup>

***

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="How do I get a referral code?">
    Reach 1,000 USD total volume, connect your wallet, and generate the code on the Referrals page.
  </Accordion>

  <Accordion title="Can I change my referral code?">
    Yes. You can set a custom code; the previous code stops working and the new one is the only active code.
  </Accordion>

  <Accordion title="How many people can use my code?">
    No limit—invite as many users as you want.
  </Accordion>

  <Accordion title="Can I use multiple referral codes?">
    No. Claiming is one-time and permanent.
  </Accordion>

  <Accordion title="What happens if someone uses my code?">
    They become your invitee. Their weekly volume drives your inviter bonus, and they get the invitee bonus (20% or 30% if you are a KOL).
  </Accordion>

  <Accordion title="Do I earn points immediately when someone uses my code?">
    No. Bonuses are added in the weekly points distribution.
  </Accordion>

  <Accordion title="Can I see how much my invitees are trading?">
    Yes, referral volume is visible on Referrals / Points (it may update with a short delay).
  </Accordion>

  <Accordion title="What if I was invited by someone?">
    After claiming you are their invitee and receive the invitee bonus (20% or 30% if their code belongs to a KOL). The code input hides and the inviter is shown in the UI.
  </Accordion>
</AccordionGroup>

***

## Related Guides

<CardGroup cols={2}>
  <Card title="Points System" icon="trophy" href="/points">
    Learn how referral bonuses contribute to your total points and how to climb the leaderboard.
  </Card>

  <Card title="Get Started" icon="rocket" href="/quickstart">
    New to ChameleonSwap? Learn how to connect your wallet and make your first swap.
  </Card>

  <Card title="Using the App" icon="book" href="/essentials/using-the-app">
    Detailed guide on all ChameleonSwap features and how to use them effectively.
  </Card>

  <Card title="FAQ" icon="circle-question" href="/faq">
    Find answers to common questions about referrals, points, and more.
  </Card>
</CardGroup>