> For the complete documentation index, see [llms.txt](https://polyhelper.gitbook.io/polyhelper-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://polyhelper.gitbook.io/polyhelper-docs/analytics-tools/top-holders-pnl.md).

# Top Holders PnL

The **Top Holders PnL** panel shows how the biggest position holders in a market are performing — split by YES and NO side, across multiple time periods.

The panel is accessible via the tab icon in the **top right corner** of every market page.

![Top Holders PnL](https://raw.githubusercontent.com/polymarkethelper/gitbook/main/.gitbook/assets/top-holders-pnl.png)

![Top Holders PnL Panel](https://raw.githubusercontent.com/polymarkethelper/gitbook/main/.gitbook/assets/top-holders-pnl.png)

***

## Holder Count Selector

At the top of the panel, choose how many top holders you want to analyze:

| Option | What It Shows                   |
| ------ | ------------------------------- |
| **10** | The 10 largest position holders |
| **20** | The 20 largest position holders |
| **50** | The 50 largest position holders |

Switching between 10/20/50 instantly updates the PnL table — useful for checking whether the signal holds beyond just the very top players.

***

## What the Table Shows

The PnL table is split by **position side** and **time period**:

|         | 24H                        | 7D | 30D | ALL |
| ------- | -------------------------- | -- | --- | --- |
| **YES** | Net PnL of top YES holders |    |     |     |
| **NO**  | Net PnL of top NO holders  |    |     |     |

* **Green** = net positive PnL for that group over that period
* **Red** = net negative PnL for that group over that period

**Example read:** if the top 20 NO holders are sitting at +$708K over 30 days and +$1.9M all-time, while YES holders are negative over the same periods — the smart money is clearly on NO.

***

## Time Period Views

| Period  | What It Reveals                                     |
| ------- | --------------------------------------------------- |
| **24H** | Who is winning today — recent momentum              |
| **7D**  | Weekly performance — short-term accuracy            |
| **30D** | Monthly view — who has been consistently right      |
| **ALL** | All-time PnL in this market — the full track record |

***

## Why This Is Powerful

### Read the Smart Money Side

The YES/NO split shows you which side the most profitable traders are on — and how long they've been right. A group of top holders sitting on +$1.9M all-time PnL is a different signal than one sitting at -$300K.

### Spot Conviction vs. Bag Holding

* **Strong positive PnL across 7D and 30D** → Top holders on this side have been consistently right. High conviction signal.
* **Negative PnL + large position** → These holders may be averaging down or stuck. Potential contrarian signal.
* **Divergence between 24H and 30D** → Something shifted recently. Worth investigating what changed.

### Informed Traders Leave Traces

Large positions combined with strong long-term PnL often indicate informed participants — traders with real research or inside knowledge. Especially relevant for political, crypto, and sports markets.

***

## How to Interpret the Data

**Top 20 NO holders at +$1.9M all-time, YES holders negative** → The large money has been right on NO for the entire life of this market. Strong directional signal.

**Both sides negative across all periods** → Market is genuinely uncertain — even the largest traders are struggling to profit. Price is likely fair.

**Positive 24H but negative 30D for a side** → Recent reversal. Something changed — check news, recent trades, or odds movement.

***

## Limitations & Caveats

{% hint style="warning" %}
PnL data is **unrealized** — it reflects the current market price, not final settlement. A trader with a large positive PnL could still lose if the market resolves against them.
{% endhint %}

* Wallet addresses are pseudonymous — you cannot verify identity without additional research
* Large holders may be hedging across multiple markets
* PnL is calculated on current odds, not accounting for trading costs

***

## Markets Where This Panel Activates

Top Holders PnL is available on **all Polymarket event pages** with sufficient liquidity and holder data.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://polyhelper.gitbook.io/polyhelper-docs/analytics-tools/top-holders-pnl.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
