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

# points, guilds & referrals

> social systems and guild launches

# points, guilds & referrals

## points

every action on gank earns points. trades, launches, referrals, daily activity. points determine your level and unlock perks.

| action      | points                 |
| ----------- | ---------------------- |
| trade       | based on volume        |
| launch      | bonus for first launch |
| referral    | per referred user      |
| daily login | streak bonus           |

leaderboards rank users by total points. check yours from the dashboard.

## referrals

### how it works

every user gets a referral code. share your link: `gank.dev/r/{your-code}`

when someone signs up through your link, you earn a commission on their trading fees. forever.

### multi-level commissions

referrals go 3 levels deep:

```
you → referred user (L1)
        → their referral (L2)
              → their referral (L3)
```

commission rates scale with your referral tier:

| tier | name      | referrals needed | L1 rate | L2 rate | L3 rate | fee discount |
| ---- | --------- | ---------------- | ------- | ------- | ------- | ------------ |
| 0    | anon      | 0                | 20%     | 5%      | 2%      | 0%           |
| 1    | scout     | 3                | 25%     | 8%      | 3%      | 5%           |
| 2    | recruiter | 10               | 30%     | 10%     | 3%      | 10%          |
| 3    | captain   | 25               | 35%     | 12%     | 4%      | 15%          |
| 4    | warlord   | 50               | 40%     | 15%     | 5%      | 20%          |
| 5    | overlord  | 100              | 50%     | 20%     | 5%      | 25%          |

higher tiers = more commission per trade your network makes, plus a fee discount on your own trades.

### milestones

hit referral milestones for bonus rewards:

* **first blood** — 1 referral
* **squad up** — 5 referrals
* **double digits** — 10 referrals
* **captain's table** — 25 referrals
* **warlord status** — 50 referrals
* **overlord** — 100 referrals

claim milestones from the referrals tab in the dashboard.

## guilds

guilds are teams. create one, invite members, climb the guild leaderboard together.

### creating a guild

any user can create a guild. set a name, description, and whether it's open or invite-only.

### guild features

* **guild leaderboard** — ranked by combined member volume and points
* **member roles** — leader, officers, members
* **guild chat** — in-app messaging for coordination
* **shared stats** — see your guild's combined trading volume and activity

### guild launches (coming soon)

the big one. guild members will be able to allocate wallets to the guild for coordinated launches:

```
guild leader configures launch
  ↓
members allocate wallets + sol
  ↓
leader launches with all allocated wallets as bundles/snipers/swarm
  ↓
profits distributed back to members automatically
  ↓
guild earns collective points
```

**how it works:**

1. guild leader creates a launch config
2. members opt in and allocate their wallets (bundle, snipe, swarm, volume)
3. each member sets how much sol they're willing to commit
4. leader triggers the launch — all member wallets participate
5. after the token runs, profits are split proportionally based on each member's sol contribution
6. automatic settlement — vamp proceeds distributed back to member wallets

this turns gank into a coordinated launch platform where groups can pool resources and share profits without trusting each other with funds. wallets stay in each member's control — the guild leader just orchestrates the launch.

### guild leaderboard

guilds compete on:

* total trading volume
* total points earned
* number of successful launches
* network size (combined referrals)

## social hub

the dashboard has a social tab with:

* **referrals** — your code, stats, earnings breakdown, milestones
* **guilds** — your guild, members, leaderboard
* **leaderboard** — points, referrals, guild rankings
* **profile** — customize your handle, connect socials