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

# Points System

> Learn how to earn points, climb the leaderboard, and unlock new leagues

## Overview

ChameleonSwap awards points for your own swaps and for your invitees’ activity. Points are distributed weekly, and KOL (Ambassador) status adds multipliers to referral bonuses plus separate revenue share.

<Card title="View Your Points" icon="trophy" href="https://chameleonswap.xyz/points" target="_blank">
  Check your current points, rank, and league on the Points page.
</Card>

***

## How Points Work

### Earning Points

Points accrue automatically from two sources:

* **Own swaps** – base points proportional to your weekly USD volume.
* **Referrals** – inviter and invitee bonuses driven by invitee volume and KOL status.

### Weekly Distribution

<Steps>
  <Step title="Trading period">
    We aggregate all swaps in the week (Monday–Sunday, UTC).
  </Step>

  <Step title="Volume calculation">
    We sum `notionalUsd` per address (own volume) and referral volume for inviters.
  </Step>

  <Step title="Point allocation">
    We grant points for own volume and add referral bonuses:

    * Inviter bonus based on invitee volume; KOLs get tier multipliers.
    * Invitee bonus = 20% boost, or 30% when the inviter is a KOL.
    * Referral points are added to the total in the weekly distribution.
  </Step>

  <Step title="Distribution">
    Points appear on the Points page after the weekly distribution completes.
  </Step>
</Steps>

<Note>
  No manual action is needed—distribution runs automatically after the weekly period ends.
</Note>

### Viewing Your Points

You can view your points in several ways:

<CardGroup cols={2}>
  <Card title="Points Widget" icon="eye">
    Check the points widget in the navigation bar (top right) when your wallet is connected.
  </Card>

  <Card title="Points Page" icon="trophy" href="https://chameleonswap.xyz/points">
    Visit the Points page for detailed information about your points, rank, and league.
  </Card>
</CardGroup>

The Points page shows:

* **Total Points** - Your cumulative points from all distributions
* **Rank** - Your position on the leaderboard
* **League** - Your current league tier
* **Total Value (USD)** - Your total trading volume in USD
* **Referral Bonuses** - Points earned from referrals (if applicable)

***

## Leagues

Leagues are achievement tiers based on your total points. As you earn more points, you'll advance through the leagues.

### League Tiers

<AccordionGroup>
  <Accordion title="Bronze League">
    <img src="https://mintcdn.com/chameleonlabs/05S52nO15p35yZ1O/images/bronze.png?fit=max&auto=format&n=05S52nO15p35yZ1O&q=85&s=1b87f788efcbb0bb69b9d87b42dc504d" alt="Bronze league badge" width="52" height="52" data-path="images/bronze.png" />

    <p><strong>Requirement:</strong> 0+ points</p>
    <p>Starting league for all users. Everyone begins here and can start earning points immediately.</p>
  </Accordion>

  <Accordion title="Silver League">
    <img src="https://mintcdn.com/chameleonlabs/05S52nO15p35yZ1O/images/silver.png?fit=max&auto=format&n=05S52nO15p35yZ1O&q=85&s=4724346b00bd566c3ff2b3888d469866" alt="Silver league badge" width="52" height="52" data-path="images/silver.png" />

    <p><strong>Requirement:</strong> 1,000+ points</p>
    <p>Reach Silver by accumulating 1,000 points through trading. This shows consistent trading activity.</p>
  </Accordion>

  <Accordion title="Gold League">
    <img src="https://mintcdn.com/chameleonlabs/05S52nO15p35yZ1O/images/gold.png?fit=max&auto=format&n=05S52nO15p35yZ1O&q=85&s=c9834029853dcaa1cefc3c8d4b8d4bef" alt="Gold league badge" width="52" height="52" data-path="images/gold.png" />

    <p><strong>Requirement:</strong> 10,000+ points</p>
    <p>Achieve Gold status with 10,000 points. This demonstrates significant trading volume and commitment.</p>
  </Accordion>

  <Accordion title="Platinum League">
    <img src="https://mintcdn.com/chameleonlabs/05S52nO15p35yZ1O/images/platinium.png?fit=max&auto=format&n=05S52nO15p35yZ1O&q=85&s=22eb78a50287ac88b991afc2b98de47e" alt="Platinum league badge" width="52" height="52" data-path="images/platinium.png" />

    <p><strong>Requirement:</strong> 50,000+ points</p>
    <p>Reach Platinum with 50,000 points. You're now among the top traders on the platform.</p>
  </Accordion>

  <Accordion title="Diamond League">
    <img src="https://mintcdn.com/chameleonlabs/05S52nO15p35yZ1O/images/diamond.png?fit=max&auto=format&n=05S52nO15p35yZ1O&q=85&s=bee9a60737a3e3aebd83d9ca536a1a94" alt="Diamond league badge" width="52" height="52" data-path="images/diamond.png" />

    <p><strong>Requirement:</strong> 100,000+ points</p>
    <p>Diamond league requires 100,000 points. This is reserved for the most active traders.</p>
  </Accordion>

  <Accordion title="Master League">
    <img src="https://mintcdn.com/chameleonlabs/05S52nO15p35yZ1O/images/master.png?fit=max&auto=format&n=05S52nO15p35yZ1O&q=85&s=d68e827002f84bc1c01bf198d6df38ea" alt="Master league badge" width="52" height="52" data-path="images/master.png" />

    <p><strong>Requirement:</strong> 500,000+ points</p>
    <p>The highest tier - Master league. Achieve 500,000 points to join the elite group of top traders.</p>
  </Accordion>
</AccordionGroup>

### Advancing Leagues

<Steps>
  <Step title="Earn Points">
    Make swaps to earn points. Every swap contributes to your total points balance.
  </Step>

  <Step title="Track Progress">
    Check your current league and points on the Points page. You'll see how many points you need for the next league.
  </Step>

  <Step title="Automatic Advancement">
    When you reach the point threshold for the next league, you'll automatically advance. No action required!
  </Step>
</Steps>

<Tip>
  League advancement happens automatically when you cross the threshold. Your league is updated in real-time as points are distributed.
</Tip>

***

## Leaderboard

The leaderboard ranks all traders based on their total points. Compete with other users to reach the top!

### How the Leaderboard Works

<AccordionGroup>
  <Accordion title="Ranking System">
    Traders are ranked by:

    1. **Total Points** - Cumulative points from all weekly distributions
    2. **Tie-breaker** - If points are equal, ranking may consider total USD volume
  </Accordion>

  <Accordion title="Top 10 Display">
    The leaderboard shows the top 10 traders on the platform:

    * Rank number (1-10)
    * Wallet address (shortened)
    * Total points
    * Total USD volume
  </Accordion>

  <Accordion title="Your Rank">
    Your rank is displayed prominently on the Points page:

    * Shows your position if you're in the top rankings
    * Updates automatically as rankings change
    * Includes your total points and USD volume
  </Accordion>
</AccordionGroup>

### Leaderboard Features

The leaderboard displays:

* **Rank** - Position number (1st, 2nd, 3rd, etc.)
* **Address** - Wallet address (shortened for privacy)
* **Points** - Total cumulative points
* **Total Value (USD)** - Total trading volume in USD

<Note>
  The leaderboard updates after each weekly distribution. Rankings may change as new points are distributed.
</Note>

***

## Referral Bonuses

Referral bonuses increase your weekly points. The rules differ for inviters and invitees.

### Bonus types

<CardGroup cols={2}>
  <Card title="Inviter Bonus" icon="gift">
    Earned by inviters from weekly USD volume of their invitees. If the inviter is a KOL, the bonus is multiplied by the KOL tier.
  </Card>

  <Card title="Invitee Bonus" icon="star">
    Earned by invitees as a boost to their own points: **20%** standard or **30%** when the code came from a KOL (visible via the 30% banner).
  </Card>
</CardGroup>

### Weekly flow

<Steps>
  <Step title="Generate or set custom code">
    After 1,000 USD volume, generate a code or set a custom code. See the [Referrals guide](/referrals).
  </Step>

  <Step title="Share and claim">
    Users claim your code; the input hides, inviter address shows, and the 20% / 30% (KOL) banner appears.
  </Step>

  <Step title="Weekly calculation">
    The system totals invitee volume, calculates inviter bonus (with KOL multiplier when applicable), and invitee bonus (20% or 30%).
  </Step>

  <Step title="Distribution">
    All referral bonuses are added to points in the weekly distribution and shown on the Points page.
  </Step>
</Steps>

### KOL tiers 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\
  KOL status is shown as **Ambassador**; their invitees see the 30% banner.

### Revenue share for KOLs

* Calculated weekly from referral volume and tier.
* Each week writes a separate record (previous weeks are not overwritten).
* Revenue share accrues alongside points—no extra action in the app.

***

## Understanding Your Points Data

### Points Breakdown

The Points page provides detailed information:

<AccordionGroup>
  <Accordion title="Total Points">
    Your cumulative points from all sources:

    * Base points from your own swaps
    * Inviter bonus points (from referrals)
    * Invitee bonus points (if you were referred)
  </Accordion>

  <Accordion title="Total Value (USD)">
    Your total trading volume in USD across all swaps. This is the basis for point calculations.
  </Accordion>

  <Accordion title="Rank">
    Your current position on the leaderboard. Lower numbers are better (1st place is rank #1).
  </Accordion>

  <Accordion title="League">
    Your current league tier based on total points. Hover over the info icon to see all league requirements.
  </Accordion>
</AccordionGroup>

### Points History

While individual swap points aren't displayed in real-time, you can track:

* Weekly point distributions (through your total balance)
* Cumulative progress toward next league
* Ranking changes over time

***

## Tips for Earning More Points

<CardGroup cols={2}>
  <Card title="Trade Regularly" icon="chart-line">
    Consistent trading throughout the week increases your share of the weekly distribution pool.
  </Card>

  <Card title="Higher Volume" icon="coins">
    Larger swap volumes result in more points. Your share is proportional to your USD volume.
  </Card>

  <Card title="Invite Friends" icon="users">
    Build a referral network to earn bonus points from your invitees' trading activity.
  </Card>

  <Card title="Stay Active" icon="fire">
    Regular trading helps maintain your rank and league position. Don't let your points stagnate!
  </Card>
</CardGroup>

***

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="How are points calculated?">
    Points are computed weekly from your USD volume plus referral bonuses. Invitee bonus is 20% (30% for KOL codes), and inviter bonus scales with invitee volume and the KOL tier multiplier.
  </Accordion>

  <Accordion title="When are points distributed?">
    Points are distributed weekly, typically after the end of each calendar week (Monday-Sunday, UTC). Distribution timing may vary.
  </Accordion>

  <Accordion title="Do I need to claim my points?">
    No, points are automatically credited to your account after distribution. You don't need to claim them.
  </Accordion>

  <Accordion title="Can I lose points?">
    Points are cumulative and don't decrease. However, your rank may change if other traders earn more points than you.
  </Accordion>

  <Accordion title="What happens if I don't trade for a week?">
    You won't earn new points for that week, but your existing points remain. Your rank may decrease as other traders earn points.
  </Accordion>

  <Accordion title="How do referral bonuses work?">
    When users you've invited make swaps, you earn bonus points based on their trading volume. These are added to your total points during weekly distributions.
  </Accordion>

  <Accordion title="Can I see my points history?">
    The Points page shows your total points and current status. Individual weekly distributions are reflected in your cumulative total.
  </Accordion>

  <Accordion title="What's the difference between points and USD volume?">
    USD volume is your total trading value. Points are rewards based on that volume, distributed proportionally each week.
  </Accordion>
</AccordionGroup>

***

## Related Guides

<CardGroup cols={2}>
  <Card title="Get Started" icon="rocket" href="/quickstart">
    Learn how to connect your wallet and make your first swap to start earning points.
  </Card>

  <Card title="Referrals" icon="users" href="/referrals">
    Learn how to generate your referral code and earn bonus points by inviting friends.
  </Card>

  <Card title="Using the App" icon="book" href="/essentials/using-the-app">
    Detailed guide on how to use all ChameleonSwap features, including swapping tokens.
  </Card>

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