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

# Token Referrals

> Earn 30% of creator fees when someone buys a token you referred

## Overview

Token referrals allow you to earn a share of creator fees when you refer the purchase of a specific token. This creates an incentive to discover and share promising tokens early.

## How It Works

<Steps>
  <Step title="Discover a Token">
    Find a token on Token Layer that you believe will attract buyers
  </Step>

  <Step title="Share with Your Referral Link">
    Share the token with your unique referral parameters
  </Step>

  <Step title="Earn from Purchases">
    When someone buys that token through your referral, you earn fees
  </Step>
</Steps>

## Earning Structure

### Commission Rate

<Card title="30% of Creator Fee" icon="percent">
  You receive **30% of the creator fee** for tokens purchased through your referral
</Card>

### Creator Fee Range

Creators earn between **\$0.20 - 20 basis points (bps)** per trade. Your 30% share is calculated from this amount.

#### Example Calculation

If a token has a creator fee of **10 bps** on a \$1,000 trade:

1. **Creator fee**: $1,000 × 0.10% = $1.00
2. **Your token referral fee**: $1.00 × 30% = **$0.30\*\*
3. **Creator receives**: $1.00 - $0.30 = **\$0.70**

## Attribution

Token referrals are attributed to the person who referred the **initial purchase** of a specific token by a specific user:

* **First-touch attribution**: The referrer who brings the user to that token gets credit
* **Per-token basis**: A user can be referred to different tokens by different people
* **Persistent**: Once attributed, all future purchases of that token by that user generate referral fees

## Creator Fee Adjustment

<Info>
  When token referral fees apply, they are **deducted from the creator's fee**, not added on top. The total fee to the trader remains the same.
</Info>

This means:

* Creators have an incentive to encourage organic discovery
* Referrers are rewarded for effective token promotion
* Traders don't pay extra fees

## Claiming Token Referral Rewards

Similar to protocol referrals, token referral rewards:

* Accrue for all quote assets
* Can be claimed once they exceed **\$1**
* Are reflected in your **spot balance** after claiming
* Can be tracked at [app.tokenlayer.network/earn](https://app.tokenlayer.network/earn)

## Combining with Protocol Referrals

You can earn **both** protocol and token referrals from the same user:

<CardGroup cols={2}>
  <Card title="Protocol Referral" icon="users">
    Earn 10% of all their trading fees
  </Card>

  <Card title="Token Referral" icon="coins">
    Earn 30% of creator fees on tokens you referred
  </Card>
</CardGroup>

### Stacking Example

If you refer a user to Token Layer (protocol referral) AND refer them to a specific token:

1. **Token referral fee**: 30% of creator fee
2. **Protocol referral fee**: 10% of (total fees - their discount)

Both fees are paid, maximizing your earning potential!

## Best Practices

<Tip>
  Focus on promoting quality tokens early in their lifecycle when there's high purchase activity
</Tip>

### Strategy Tips

* **Early discovery**: Find promising tokens before they're widely known
* **Quality over quantity**: Share tokens you genuinely believe in
* **Educational content**: Explain why a token is interesting
* **Track performance**: Monitor which tokens generate the most referral revenue

### Promotion Channels

<CardGroup cols={2}>
  <Card title="Social Media" icon="share">
    Twitter threads, Discord messages
  </Card>

  <Card title="Content Creation" icon="video">
    YouTube reviews, blog posts
  </Card>

  <Card title="Communities" icon="users">
    Trading groups, forums
  </Card>

  <Card title="Direct Outreach" icon="envelope">
    Personal recommendations
  </Card>
</CardGroup>

## Token Selection Criteria

When choosing tokens to promote, consider:

* **Creator reputation**: Well-known creators may attract more buyers
* **Community engagement**: Active communities drive more trading
* **Token utility**: Tokens with clear use cases may have more sustained interest
* **Market timing**: Early-stage tokens may have higher purchase velocity

## Transparency

<Check>
  Always disclose that you may earn referral fees when promoting tokens
</Check>

Being transparent builds trust and complies with potential regulatory requirements in your jurisdiction.

## API Integration

Use the API to create tokens with referral tracking built-in:

<Card title="Create Token Transaction API" icon="code" href="/api-reference/transactions/create-new-token-transaction">
  Create tokens with referral tracking enabled
</Card>

## Questions?

For more information about token referrals, click the chat icon in the bottom right corner to get help.