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

# Leaderboard

> How points are earned across InkyPump V1, V2, and InkySwap LP.

The InkyPump leaderboard counts three categories of points and combines them into a single ranking.

## What gets counted

| Category                | Source                | What earns points                                      |
| ----------------------- | --------------------- | ------------------------------------------------------ |
| InkyPump trading points | V1 and V2 trades      | ETH volume traded, with a multiplier for the fee model |
| InkySwap points         | InkySwap V4 swaps     | ETH volume swapped on the broader InkySwap DEX         |
| LP points               | InkySwap LP provision | Time weighted liquidity provided to InkySwap pools     |

The leaderboard adds the three categories together for the total ranking. Each category is also visible separately in the UI.

## How V1 and V2 trading points differ

V1 and V2 had different fee models. The point formula adjusts so the points earned reflect the gross volume, not the net of fees.

| Version | Fee       | Formula (gross volume per ETH spent) |
| ------- | --------- | ------------------------------------ |
| V1      | 5 percent | `ethSpent * 100 / 95`                |
| V2      | 2 percent | `ethSpent * 100 / 98`                |

This means a 1 ETH trade on V2 counts more in volume than a 1 ETH trade on V1 because the V2 trade paid less in fees.

The leaderboard shows the resulting points number directly. You do not need to do the math yourself.

## Referral points

A separate referral category counts points earned by referring trades. When someone trades using your referral code, you accrue points equal to a fraction of their volume. This is computed off chain by the InkyPump backend from the on chain `Referral` events emitted by V2 trades.

V1 trades also count for referrals if the user passed a referral code on the legacy contract.

For mechanics, see [Referrals](/rewards/referral).

## Token creation points

Creating a launch awards a flat creation bonus. Creating a launch with a valid referral code awards an additional bonus to the referrer.

## Where the data comes from

The leaderboard updates as soon as new trades are indexed.

* V2 events are indexed from the InkyPump V2 hook at `0x4cC8F6d5B7cE150CCC0A9B7664532B1283b96AC4`
* V1 events are indexed from the legacy `TokenFactory` at `0x1D74317d760f2c72A94386f50E8D10f2C902b899`
* InkySwap LP and swap events come from the wider InkySwap V4 deployment

## API

To pull the leaderboard data into your own application, use the [GET /api/leaderboard](/api-reference/inkypump/leaderboard) endpoint. It returns the same data the UI renders.

## Reset and snapshots

The leaderboard is cumulative. There is no reset.

For ranked events or seasonal competitions, InkyPump runs separate snapshots that capture point balances at a fixed time. Those are announced on the [InkyPump Telegram](https://t.me/inkyswap) and [X](https://x.com/inkyswap) when they happen.