How to Read Polymarket’s Trader Rankings Without Misreading the Numbers

Polymarket leaderboards are best used to discover wallets for further analysis—not as proof of skill. Every ranking depends on its retrieval time, period, category, sorting metric, and accounting method. Day, week, and month PnL can include changes in the marked value of unresolved positions, while all-time PnL is realized-only. Official leaderboard volume is measured in shares, not dollars. Polymarket’s Boards documentation defines these distinctions.

Where to find the official Polymarket leaderboards

Start with the official Polymarket leaderboard. It is Polymarket’s first-party ranking, distinct from independent analytics and copy-trading products that may apply their own calculations.

The interface provides leaderboard areas for Predictions, Perps, and Combos. On the trader board, the principal controls are:

• Period: Today, Weekly, Monthly, or All
• Category: All Categories or a selected category
• Metric: Profit/Loss or Volume

These controls define the ranking. First place on a monthly overall PnL board is not equivalent to first place on a daily sports volume board.

The board is dynamic, so any ranking is only a snapshot. Whenever you record or publish a leader, include:

1. Retrieval date and time
2. Timezone
3. Leaderboard area and category
4. Period
5. Ranking metric

A reproducible label would read: “Retrieved at [HH:MM UTC on YYYY-MM-DD]; Predictions; Overall; Month; PNL.” Without that context, a statement about who “leads” cannot be interpreted reliably.

As an undated historical example only, a Monthly / All Categories / Profit-Loss view displayed wallet 0x950941d8ee0fb420b66cb5131c83de7bf5fc1d4c first at +$5,869,917. This does not identify the current leader. See the official leaderboard view.

What each filter changes

Control	Supported options	What changes	Main interpretation warning
Time period	day, week, month, all	Performance window; day is the API default	Finite-window and all-time PnL use different accounting methods
Category	overall, Gamma market categories, esports, combos	Markets included; overall is the default	combos applies only to PnL boards
Sort	PNL, VOLUME	Whether rows are ordered by profit/loss or activity; PNL is the default	Volume does not measure profitability

Category selection can substantially reorder the board. “Overall” pools qualifying activity, while a category narrows the ranking to associated markets. Esports and combos are documented as synthetic categories. Combos applies only to PnL: a combos volume query has no leaderboard rows.

The unit attached to volume is especially important. Polymarket’s official leaderboard volume is measured in shares, not USDC or dollar turnover. A third-party table showing “$20 million volume” is therefore not another display of the same official metric and cannot be compared directly with a share-volume rank. Polymarket documents the board’s filters, defaults, and units.

Why monthly and all-time PnL are not the same measure

The key accounting distinction is:

• Day, week, and month PnL measure marked equity change net of flows. They can move when unresolved positions are repriced.
• All-time PnL is a realized-only lifetime ledger.

These are not simply different windows calculated with one identical formula. Polymarket’s Boards documentation expressly distinguishes finite-window marked PnL from all-time realized PnL.

Suppose a wallet holds unresolved positions whose market prices rise during the month. It can climb the monthly PnL board because its open inventory has gained marked value, even though it has not sold those positions or received resolution payouts. If the prices later fall, the finite-window result can change.

The all-time board asks a different question because it focuses on realized lifetime results. Researchers should label both measures explicitly rather than subtracting one from the other or treating them as directly comparable periods.

Neither measure by itself establishes:

• Return on investment
• Capital efficiency
• Risk-adjusted return
• Maximum drawdown
• Forecast calibration
• Repeatable forecasting skill

Leaderboard PnL reports profit or loss under the board’s accounting rules. It does not reveal how much capital was required, how concentrated the exposure was, or how much risk remains open.

How ranks, ties, and wallet lookups work

Leaderboard rank is not necessarily the same as row number. Tied users share a rank, and subsequent ranks are skipped. A sequence could therefore read 1, 2, 2, 4.

For that reason, a displayed rank cannot safely be converted into a page number or API offset. Pagination should use the supplied cursor.

The API’s user parameter switches the request into a different mode. Instead of returning a page of traders, it returns one wallet’s standing with both its PnL rank and volume rank in a single object.

Two details matter:

• A rank of 0 means unranked, not first place.
• sort_by, limit, and cursor do not apply in single-wallet lookup mode.

These rank, tie, and lookup rules are specified in the official Boards documentation.

Treat the returned wallet address or username as a platform identifier. A username is not proof of a verified real-world identity, and a profile-level result should not automatically be assumed to represent one natural person.

Retrieving leaderboard data through the official API

For a new integration, use Polymarket’s newer Boards documentation rather than building around the older v1 route. The current interface has two response modes:

1. Board mode: returns a paginated leaderboard page.
2. Wallet mode: returns one wallet’s PnL and volume standing.

For the first board page, limit can range from 0 to 1000. Deeper pages use the opaque next_cursor returned by the preceding response. The cursor is bound to the board’s sort, time window, and category; restating a conflicting parameter can produce a 400 response.

A board request can follow this pattern:

first_page = request_current_boards_endpoint(
    time_period = "month",
    category = "overall",
    sort_by = "PNL",
    limit = 100
)

save(first_page.rows)
cursor = first_page.next_cursor

while cursor exists:
    next_page = request_current_boards_endpoint(
        cursor = cursor
    )

    save(next_page.rows)
    cursor = next_page.next_cursor

A single-wallet lookup is separate:

standing = request_current_boards_endpoint(
    user = WALLET_ADDRESS
)

read(standing.pnl_rank)
read(standing.volume_rank)

if either rank == 0:
    interpret as "unranked"

Do not attach sort_by, limit, or cursor to the wallet lookup.

Legacy API note

Polymarket still documents https://data-api.polymarket.com/v1/leaderboard, but explicitly categorizes it as Data API v1 (Legacy). Its example uses category=OVERALL, timePeriod=DAY, orderBy=PNL, and limit=25. The legacy API documentation is useful for identifying older code, not as the preferred basis for a new integration.

Why another PnL calculation may not match the leaderboard

First confirm that both figures use the same accounting basis. A finite-period marked-equity result and an all-time realized result answer different questions, even for the same wallet.

Other possible sources of disagreement include:

• Incomplete transaction or activity history
• Different treatment of open positions
• Rebates
• Redemptions, merges, splits, or conversions
• Indexing lag
• Fees
• Possible aggregation of proxy wallets into a profile result

A Leo Labs technical case study reports that summing the positions API’s cashPnl field can omit automatically redeemed winning positions and materially disagree with leaderboard totals. It proposes this reconstruction:

SELL + REDEEM + MERGE + REBATE
- BUY - SPLIT
+ current position market value

This is a third-party reconciliation method, not Polymarket’s definitive formula. The formula and its supporting tests are described in the Leo Labs PnL calculation case study.

The same case study reports practical hazards including activity-history offsets beyond 3,000 records, accidental removal of genuine multiple fills during deduplication, rate limits, and timeouts on large histories. It also says NegRisk conversions and taker fees may leave gaps after reconstruction. Those findings are third-party observations and may not apply uniformly to every wallet or future API behavior.

Third-party products can deliberately use different definitions. Polydata, for example, describes its headline PnL as realized cash flow—sells minus buys plus payouts from resolved winners—without fully marking open positions. It says open-position treatment, rebates, NegRisk conversions, and indexing lag can produce differences from Polymarket’s interface. This can be useful within that provider’s methodology, but it is not “the” official PnL.

A sound reconciliation compares:

1. The same wallet or profile scope
2. The same timeframe
3. The same realized-versus-marked treatment
4. The same transaction types
5. The same fees and rebates
6. The same valuation timestamp

An independently reconstructed total should be presented as an estimate under a disclosed method, not as a definitive replacement for the official board.

A practical checklist for evaluating a ranked wallet

Use a leaderboard to choose what to investigate, not whom to imitate. A high rank can reflect broad performance, one large outcome, marked gains on open positions, heavy activity, or risks hidden by the headline number.

• Confirm the period and PnL definition. Determine whether you are reading finite-window marked PnL or all-time realized PnL.
• Compare recent and lifetime results. Strong cumulative results can coexist with a recent loss.
• Inspect volume and trade count together. Similar PnL can come from a few large positions or many small trades.
• Separate realized results from unresolved exposure. Open inventory can reverse before resolution or exit.
• Measure concentration. Break exposure down by market, event, and category.
• Remove the largest win as a sensitivity test. Check whether the broader record remains positive.
• Review drawdown. Peak-to-trough losses reveal information cumulative PnL hides.
• Use ROI only with a disclosed definition. Capital deployed, recycled capital, and open exposure must be handled consistently before comparisons are meaningful.

As an illustration rather than a representative study, a Leo Labs analysis examined 40 selected sports and crypto wallets and reported different transaction patterns between the groups. Sports wallets in that sample more often appeared directional, while several crypto wallets appeared consistent with market making or inventory management. It also described a wallet with strong cumulative profit but a loss over the preceding 30 days. The 40-wallet analysis shows why recent performance and transaction structure matter, but its strategy labels remain inferences. Trading records can suggest a strategy; they do not prove intent.

Third-party boards may rank wallets differently because they can use realized cash flow instead of marked PnL, dollar volume instead of share volume, different windows, limited coverage, different category mappings, or different indexing schedules. Polytrack, for example, expressly describes its ranking as based only on monitored data and says it is neither Polymarket’s official nor complete leaderboard.

The compact reading rule is: record the timestamp, period, category, and metric; determine whether PnL is marked or realized; treat official share volume and third-party dollar volume as different measures; then inspect recent results, concentration, drawdown, and open exposure. A Polymarket leaderboard is an index of measured platform performance—not a verdict on identity, skill, or what anyone should trade. This analysis is informational and not trading advice.

How often does the official Polymarket leaderboard update?

Polymarket’s displayed leaderboard is dynamic, but the available official page does not establish an exact refresh interval. Treat every view as a timestamped snapshot rather than assuming a fixed real-time, hourly, or daily schedule.

Is the Polymarket leaderboard available to US visitors?

The international Polymarket page currently states that trading on polymarket.com is blocked in the United States, directs US visitors to Polymarket US, and offers a view-only continuation. These notices can change, so check the live official access notice at publication or access time rather than assuming that viewing a board means trading is available.

Are third-party Polymarket leaderboards official or affiliated with Polymarket?

Not merely because they analyze Polymarket wallets or use platform data. Third-party boards can apply their own coverage, windows, units, metrics, and ranking rules. For example, Polytrack says its board uses monitored data and is not Polymarket’s official or complete leaderboard. Check each provider’s affiliation statement and methodology before comparing its rankings with Polymarket’s first-party board.