# Leaderboard
## ๐จโ๐ป How It Works
**Every new** [queried coin ](/phanes/commands.md#price-queries)will be added to the tracking system automatically.
If you are only scanning a coin **you'd have to click** on the button.
The button expires after **2 minutes**. After the time has elapsed, the option to remove the call is no longer available.
{% tabs %}
{% tab title="โญ๏ธ Example" %}
{% hint style="info" %}
Top Callers are determined by a **points-based system**. To be eligible for the list, you must have earned at least 1 point. Learn more [here](#points-system).
{% endhint %}
{% endtab %}
{% tab title="๐ฒ Emoji Guide" %}
The first emoji represents the user's rank, more [here](https://docs.phanes.bot/phanes/leaderboard#emoji-ranks).
The second emoji represents the chain:
| Emoji | Definition |
| ------------- | --------------------------------------- |
| ๐ | Called on Pump.Fun **before migration** |
| ๐ฃ | Solana |
| ๐ท | Ethereum |
| ๐ต | Base |
| ๐ธ | BSC |
| ๐ก | Ton |
| ๐บ | Avax |
| โฆ๏ธ | Tron |
| {% endtab %} | |
| {% endtabs %} | |
{% hint style="warning" %}
### We Recommend
1. Turn off [**anonymous appearance**](#user-content-fn-1)[^1] in your group.
2. Set a [**Telegram Username**](https://telegram.org/blog/usernames-and-secret-chats-v2?setln=it) to avoid appearing as "Anonymous" or "None" on the Leaderboard.
{% endhint %}
***
## ๐ฎ Commands
* `/lb` or `/leaderboard`
* For periods > 1 day, only these are allowed:\
`1d, 2d, 3d, 4d, 5d, 6d, 7d, 14d, 1mo, 2mo, 3mo, 4mo, 5mo`.
* View a longer leaderboard with: `/lb 1d 25` which returns the top 25.
* Set a minimum ATH: `/lb 1d $1m`, `/lb $500k`.
* Hide names: `/lb anon`, `/lb 7d anon`.
* `/wlb`: View the Web Leaderboard
* `/calls`: [View the last 10 calls.](#user-content-fn-2)[^2]
* `/stats <@username>`: View user's stats from your group. For more click [here](#user-stats).
* `/pnl ` & `/gpnl `: Generate a PNL / Group PNL image.
* `/fc `: [Get first caller information](#user-content-fn-3)[^3].
* `/elb`: Export the leaderboard into a CSV file. For more click [here](https://docs.phanes.bot/phanes/leaderboard#export-leaderboard).
***
## โก๏ธ Core Performance Metrics
### **Top Callers**
The Top Callers system is based on the user rankings point system. It highlights the most successful callers based on their accumulated points from all calls within the specified timeframe. Points are awarded according to the [points system](#points-system).
### Hit Rate
The hit rate shows how consistently a caller finds tokens that achieve significant gains. It's calculated as the percentage of calls that reach at least 2x return. For example, a 40% hit rate means that 4 out of 10 calls reached or exceeded 2x return. This metric helps identify callers who consistently spot potential winners rather than those who might get lucky with one big call.
### **Average Return**
The average return (mean) represents the typical performance across all calls. It's calculated by adding up all returns and dividing by the number of calls. While this gives a good overall performance indicator, it can be heavily influenced by extremely successful calls. For instance, one 100x call among many smaller returns will significantly boost the average, which might not represent the typical performance.
### **Median Return**
The median return provides the middle value when all returns are ordered from lowest to highest. Unlike the average, it's not skewed by extremely high or low returns, making it often a better representation of typical performance. If a caller has a median return of 3x, it means half their calls performed better than 3x and half performed worse. This metric is particularly useful for understanding a caller's consistent performance level.
> *To learn more about median* [*click here*](https://www.investopedia.com/terms/m/median.asp)*.*
{% hint style="success" %}
Together, these metrics provide a comprehensive view:
* **Top Callers** shows relative performance ranking based on the point system.
* **Hit Rate** shows consistency in finding winners.
* **Average Return** shows overall performance including big wins.
* **Median Return** shows typical performance excluding outliers.
Using all these metrics gives the most accurate picture of a caller's performance, as each metric compensates for the limitations of the others.
{% endhint %}
***
## ๐ฅ๏ธ Ranking System
The user rankings are calculated using a point-based system that rewards or penalizes users based on the performance of their calls. Here's how points are assigned:
### **How It Works**
* Each user starts with 0 points
* Points are accumulated for each call based on its performance
* Poor calls result in negative points to penalize bad performance
* Higher multipliers earn exponentially more points to reward exceptional calls
* Final rankings are sorted from highest to lowest total points
### **Scoring Tiers**
{% tabs %}
{% tab title="๐งฎ Points System" %}
### **How points are awarded per call**
#### Base Points
* **-2** points ยป below **1x**
* **-1** point ยป **1x to 1.3x**
* **0** points ยป **1.3x to 1.8x**
* **+1** point ยป **1.8x to 5x**
* **+2** points ยป **5x to 10x**
* **+3** points ยป **10x to 20x**
* **+4** points ยป **20x to 50x**
* **+7** points ยป **50x to 100x**
* **+10** points ยป **100x to 200x**
* **+15** points ยป **200x or higher**
#### **Market Cap Multiplier**
* Below **$25K** MC: **ร0.5** (half points)
* **$25K - $50K** MC: **ร0.75** (25% reduced points)
* **$50K - $1M** MC: **ร1.0** (normal points)
* Above **$1M** MC: **ร1.5** (50% bonus points)
*(only applies to positive number)*
{% endtab %}
{% tab title="โ๏ธ Caller Ranking" %}
**Emoji shown next to user's total points.**
* ๐ญ Negative points
* ๐ 0 to 1 points
* ๐ 2 to 4 points
* ๐ 5 to 9 points
* ๐ธ 10 to 14 points
* ๐ฅ 15 to 19 points
* ๐ 20 to 29 points
* ๐ 30+ points
{% endtab %}
{% tab title="โก๏ธ Return Multiplier" %}
**Emoji shown next to individual calls.**
* ๐ญ Below 1.2x
* ๐ฅฑ 1.2x to 1.8x
* ๐ 1.8x to 5x
* ๐ 5x to 15x
* ๐ธ 15x to 30x
* ๐ฅ 30x to 50x
* ๐ 50x to 100x
* ๐ 100x or higher
{% endtab %}
{% endtabs %}
{% hint style="success" %}
This System:
* Rewards consistency and high-performance calls.
* Penalizes poor calls and pump chasing.
* Provides more weight to exceptional performances.
* Creates a balanced scoring system that reflects both consistency and ability to spot big winners.
The final user rankings provide a competitive leaderboard that reflects both the quality and consistency of a user's calling ability.
{% endhint %}
***
## ๐จโ๐ณ User Stats
You are able to view user stats by either clicking on the user's name within the leaderboard or by using the command: `/stats <@username>`.
{% hint style="warning" %}
Phanes always verifies that the user requesting statistics is a member of the group, to prevent unauthorized access. **To ensure this security measure works effectively, Phanes requires admin privileges in your group.**
{% endhint %}
***
## ๐ธ PNL Card
We offer **free custom-designed** PNL cards for every first caller in your group.
The X return is specifically calculated using:
1. The market cap at the time of first call in the group
2. The highest market cap reached after the call (ATH)
You can generate a PNL image with `/pnl ` or by clicking on an emoji within your `/leaderboard`.
***
## ๐ธ Group PNL Card
You can generate a Group PNL with `/gpnl `, e.g. `/gpnl 7d`.
Group PNL Image
***
## ๐ Export Leaderboard
[Pro](/premium/phanes-pro.md) subscribers are able to export the Leaderboard to a CSV file with `/elb `.
{% hint style="info" %}
Group admins can limit the use of this command to admins only by using `/allow_elb `.
{% endhint %}
[^1]: To turn off the anonymous mode go into your group settings ยป Administrators ยป Right click the user you want to edit ยป Edit admin rights ยป Toggle off "Remain anonymous".
[^2]: 
[^3]: 
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.phanes.bot/phanes/leaderboard.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.