> For the complete documentation index, see [llms.txt](https://docs.nectarliquid.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nectarliquid.com/leaderboard.md).

# Leaderboard

The Nectar Liquid Leaderboard provides a transparent real time ranking of the top performing traders on the platform. Built on the public ledger of Asset Chain, the leaderboard aggregates on chain trading data through platform API integrations to display accurate profit and loss (PnL), win rates, and trading behaviors.

Whether you are looking to track your own performance, analyze the strategies of highly profitable whales, or compete for ecosystem rewards, the Leaderboard serves as the central hub for trading analytics.

#### Environment Isolation

The Leaderboard operates independently across both active protocol networks. Data is never mixed between environments to ensure accurate statistics.

* Mainnet Leaderboard
  * Application URL: `https://app.nectarliquid.com/#/leaderboard`
  * Data Source: Live production trading contracts on Asset Chain Mainnet.
  * Core Focus: Tracking real capital performance, institutional volume, and production trading reward epochs.
* Beta Testnet Leaderboard
  * Application URL: `https://testnet.nectarliquid.com/#/leaderboard` (or `https://nectar-liquid.netlify.app/#/leaderboard`)
  * Data Source: Sandbox testing contracts on Asset Chain Testnet.
  * Core Focus: Risk free strategy optimization, developer API benchmarking, and testnet simulation tournaments.

#### Navigating the Leaderboard

You can access the Leaderboard directly from the main navigation menu across both web apps. The interface allows you to filter and analyze data across multiple specific timeframes using an environment filter and a chronological toggle.

Using the dropdown toggle menu at the top right of the dashboard, you can adjust the data scope to the following periods:

* 24H: Tracks performance over the last rolling 24 hours which is ideal for highly active day traders.
* 7D: Tracks performance over the last 7 days.
* 14D: Tracks performance over the last 14 days.
* 30D: Tracks performance over the last month.
* ALL: Aggregates the total historical performance of the wallet since its first recorded transaction on that specific network.

When you switch between these timeframes, all metrics on the board recalculate dynamically to reflect that specific window of time.

#### Leaderboard Metrics

The Leaderboard table is broken down into several key columns that provide a comprehensive overview of a trader risk profile and success rate. Every column header includes a sorting toggle allowing you to rank traders by any specific metric.

* Rank: The numerical standing of the trader based on the currently sorted column. By default, the leaderboard ranks traders by the highest absolute PnL in the selected timeframe.
* Address: The connected Web3 wallet address of the trader. To improve readability and community engagement, Nectar Liquid supports custom handles and tags like `@NECTAR` which allows traders to build a recognizable identity on the platform without exposing their raw hexadecimal address.
* PnL: The absolute fiat USD value of the trader Profit and Loss during the selected timeframe. This includes both realized profits from closed positions and unrealized profits from currently open positions, minus trading fees and borrowing costs.
* PnL (%): The percentage return relative to the collateral utilized. This metric levels the playing field, allowing traders with smaller capital to demonstrate their trading efficiency and compete against high volume whales.
* Average Size: The average USD notional size of the positions opened by the trader during the timeframe. This provides insight into whether the user is trading with massive size or managing a portfolio of smaller trades.
* Average Leverage: The average leverage multiplier used across all of the user trades. This metric is an excellent indicator of a trader risk appetite. A highly profitable trader with low average leverage is utilizing a very different strategy than one with a high average leverage.
* Gain Loss: The absolute ratio of winning trades to losing trades like 15 / 4. This acts as a clear indicator of a trader overall win rate and consistency.

#### Search and Analysis

If you want to track a specific wallet, verify the performance of a friend, or monitor an affiliate trading activity, you can use the Search address bar located at the top left of the table.

Simply paste the wallet address or type the custom handle into the search bar. The leaderboard platform API will instantly filter the database to display that specific user metrics across the selected timeframe.

#### Transparency and Real Time Updates

Because Nectar Liquid is natively deployed on Asset Chain, the Leaderboard benefits from the network sub second finality. Unlike centralized exchanges where leaderboard data might be delayed or manipulated, every metric displayed here is mathematically derived directly from on chain smart contract executions.

When a trader closes a profitable position or their open position fluctuates in value based on the oracle price feeds, the Leaderboard updates to reflect these changes with near zero latency.

#### Competitions and Gamification

The Leaderboard is the foundation for Nectar Liquid community gamification across both deployments.

* Trading Competitions: During official Nectar Liquid trading epochs, the Leaderboard is used to determine the winners of prize pools. Mainnet competitions award production assets, while Testnet competitions allow developers and users to win ecosystem incentives based on the highest absolute PnL, highest PnL percentage, or highest total trading volume.
* Affiliate Tracking: If you are participating in the Nectar Liquid Referral Program, you can use the leaderboard to monitor the aggregate performance of the traders you have invited, giving you insight into the trading volume that is generating your fee rebates.

#### Privacy

By default, Web3 trading is pseudo anonymous. Your trading statistics are linked to your wallet address and are publicly verifiable on the blockchain. If you wish to maintain strict privacy regarding your trading sizes and PnL, we recommend using a dedicated trading wallet distinct from your primary holding wallet.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.nectarliquid.com/leaderboard.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
