Polymarket Wallet Leaderboard | BlockRun

Compare ranked Polymarket wallet records by performance window and sorting metric. No wallet address is needed; optional filters narrow the page you receive.

Your AI

Use with your AI

For tasks with several steps, continue in the AI you already use.

CodexClaude CodeCursorWindsurfCline

View instructions

Use the exact Tool polymarket-leaderboard-blockrun to show up to five wallets from the all-time Polymarket leaderboard, sorted by total PnL descending. Compare realized PnL, trading volume and supplier style labels, keeping missing values visible. Reuse my Toolmu connection; if setup is needed, follow https://toolmu.com/SKILL.md. Read get_tool for this exact name and the rules at https://docs.predexon.com/api-reference/analytics/leaderboard. Before an authorized run, check current availability, maximum credits, balance and my existing authorization and budget.

Place supported controls directly in queryParams, never inside queryParams.query. A general first page needs no selector. Retain valid choices already supplied: window is 1d, 7d, 30d or all_time (default all_time); sort_by is realized_pnl, total_pnl, volume, roi, profit_factor, win_rate or trades (default total_pnl); order is asc or desc (default desc); limit is an integer from 1 to 100, defaulting to 100. style is a comma-separated OR inclusion string and exclude_style is a comma-separated exclusion string. Use only the documented min/max numeric filters and their bounds; PnL, volume and average trade amounts use USD, ROI and win-rate thresholds use decimals, average-price thresholds use 0–1, and entry-edge thresholds use −1 to 1. Do not add Boolean label filters, a wallet or market selector, or custom dates. If a requested intersection, include/exclude combination, filter-window interaction or other unsupported condition is unclear, ask how to proceed before changing scope. Do not silently replace AND with OR, drop conditions or change the window. Do not ask again for valid optional information or impose extra required fields.

Compare the returned window and ranking metric. USD total_pnl is realized plus unrealized PnL minus net fees; fees_paid already nets refunds and the deprecated fees_refunded value must not be deducted again. ROI and win_rate are decimals (0.5 is 50%); their denominators and zero handling are unspecified. Profit factor means gross profit divided by gross loss, with unspecified zero-loss behavior: keep returned values, including 0. Preserve overlapping flags and primary_style without reclassifying wallets or treating them as verified people, quality ratings or forecasts. Average prices use the 0–1 scale, without an established currency, calibrated-probability or executable-quote guarantee. entry_edge is documented only for all_time; retain its nulls and precision. first_trade_at is a Unix integer with no specified seconds/milliseconds unit, so keep it raw. Separate zero, false and null.

Report an empty or failed result without broadening or automatically retrying. Continue only within my requested scope and authorized budget when has_more is true and a nonempty pagination_key string is actually returned. Pass that key unchanged directly in queryParams.pagination_key, retaining window, sort_by, order, styles, every threshold and page limit. Stop if the key is missing, null or empty; do not decode or invent it, calculate an offset or replay the first page.

Task:
Show the first five wallets on the Polymarket ranking for all recorded history. Compare their reported gains or losses, trading volume, and number of trades. Mention any missing figures.

Paste into your connected AI's conversation.

Connection guide

Up to 0.01122 credits / call

The final charge is based on confirmed usage. Unused reserved credits return to your available balance.

BlockRun

Polymarket Wallet Leaderboard | BlockRun

Compare ranked Polymarket wallet records by performance window and sorting metric. No wallet address is needed; optional filters narrow the page you receive.

You receive

Get a page of ranked Polymarket wallets with addresses, profit and loss, trading volume, rates, trade counts and closed-position counts. Each record also carries the supplier’s trading-style labels, which can overlap. Your Agent can place these records side by side using the same window and metric definitions, showing missing values alongside the reported amounts.

Start with your task

Show the first five wallets on the Polymarket ranking for all recorded history. Compare their reported gains or losses, trading volume, and number of trades. Mention any missing figures.

What to know

A wallet address does not verify a person, and past performance or a style label does not predict future returns. The page is not an exhaustive wallet inventory or a guarantee of current rankings. Label calculations may use a different scope from the selected performance window.

Inputs & outputs

Inspect the current inputs, availability, and maximum charge before starting.

Input schema

Input schema
Field / Path	Type	Requirement	Meaning
Ranking filters`queryParams`	`object`	Optional	Optional container for leaderboard controls placed directly in queryParams. A general first page needs no wallet or market identifier.
Nested query object`queryParams.query`	`object`	Optional	Optional generic object with no declared children. Put this endpoint’s documented controls directly in queryParams.

View raw JSON

{
  "type": "object",
  "required": [],
  "properties": {
    "queryParams": {
      "type": "object",
      "properties": {
        "query": {
          "type": "object",
          "required": [],
          "properties": {}
        }
      }
    }
  },
  "additionalProperties": false
}

Result schema

No fixed output contract is available. Field types reflect saved result evidence; individual responses can differ.

Result schema
Field / Path	Type	Meaning
Metrics window`result.window`	`string`	The selected 1d, 7d, 30d or all_time metrics window. It is not a custom calendar interval.
Ranking metric`result.sort_by`	`string`	The performance field used to sort the page. Read each rank alongside the window, order and filters.
Wallets on this page`result.entries`	`array`	The returned wallet ranking records. Addresses identify wallets, not verified people.
Reported rank`result.entries[].rank`	`number`	The one-based leaderboard position assigned by the source. Tie rules and rank changes after filtering are not specified.
Wallet address`result.entries[].user`	`string`	The wallet address attached to this record. It does not establish a person’s identity or your ownership.
Performance metrics`result.entries[].metrics`	`object`	Reported performance for the selected window. Compare wallets using the same window and definitions.
ROI, decimal`result.entries[].metrics.roi`	`number`	Return on investment as a decimal: 0.5 means 50%. The denominator and zero handling are unspecified; values above 1 remain valid raw values.
Winning closed positions`result.entries[].metrics.wins`	`number`	The number of winning positions closed. This is not a count of individual successful trades.
Losing closed positions`result.entries[].metrics.losses`	`number`	The number of losing positions closed. This is distinct from individual trades.
Trade count`result.entries[].metrics.trades`	`number`	Trades counted within the metrics window, separate from closed positions and wallet counts.
Trading volume, USD`result.entries[].metrics.volume`	`number`	Trading volume in USD within the window. It measures turnover rather than wallet balance or current holdings.
Win rate, decimal`result.entries[].metrics.win_rate`	`number`	The source win-rate decimal: 0.6 means 60%. Its denominator and zero handling are not specified; do not derive it from other counts.
Net taker fees, USD`result.entries[].metrics.fees_paid`	`number`	Taker fees in USD with refunds already netted into this field.
Total PnL, USD`result.entries[].metrics.total_pnl`	`number`	Total profit or loss in USD: realized plus unrealized PnL minus net fees. Missing totals stay null.
Realized PnL, USD`result.entries[].metrics.realized_pnl`	`number`	Profit or loss in USD from closed positions within the metrics window.
Average buy price`result.entries[].metrics.avg_buy_price`	`number`	Nullable volume-weighted average buy price on the source 0–1 scale. It is not a current executable quote or a calibrated probability.
Legacy fee-refund value`result.entries[].metrics.fees_refunded`	`number`	Deprecated field documented as always 0. Refunds are already netted into fees_paid; retain the raw value without another deduction.
Profit factor`result.entries[].metrics.profit_factor`	`number`	The source gross-profit/gross-loss ratio. Zero-loss behavior is unspecified; retain a returned 0 instead of replacing it with infinity.
Average sell price`result.entries[].metrics.avg_sell_price`	`null \| number`	Nullable volume-weighted average sell price on the 0–1 scale. Null is a missing value, not a price of zero.
Closed-position count`result.entries[].metrics.positions_closed`	`number`	The number of closed positions. It need not equal the sum of winning and losing position counts.
Trading-style labels`result.entries[].trading_styles`	`object`	Supplier classifications that can overlap. Their calculation window is not explicitly tied to the requested metrics window.
Degen label`result.entries[].trading_styles.is_degen`	`boolean`	The supplier’s low-win-rate and high-closure-count classification. It is not an independent assessment of risk or quality.
Whale label`result.entries[].trading_styles.is_whale`	`boolean`	The supplier’s large-average-trade classification. Keep the assigned flag rather than recomputing an unresolved threshold boundary.
Contrarian label`result.entries[].trading_styles.is_contrarian`	`boolean`	The supplier’s low-average-entry-price classification. It is not a recommendation to take an opposing position.
Primary trading style`result.entries[].trading_styles.primary_style`	`string`	The returned primary_style classification. Keep it separately from overlapping Boolean flags and do not replace it with a new classification.
Buy-and-hold label`result.entries[].trading_styles.is_buy_and_hold`	`boolean`	The supplier’s low-trades-per-position classification. A numeric holding-duration threshold is not specified.
Market-maker label`result.entries[].trading_styles.is_market_maker`	`boolean`	The supplier’s balanced-buy/sell and frequent-trading classification. It does not prove an exchange role or current liquidity provision.
Value-hunter label`result.entries[].trading_styles.is_value_hunter`	`boolean`	The supplier’s midrange-entry-price classification. It does not verify that an investment is undervalued.
Active-trader label`result.entries[].trading_styles.is_active_trader`	`boolean`	The supplier’s high-trades-per-position classification. The label’s calculation window is not specified.
High-conviction label`result.entries[].trading_styles.is_high_conviction`	`boolean`	The supplier’s high-average-entry-price classification. It does not establish a person’s confidence or future returns.
Average entry edge`result.entries[].entry_edge`	`null \| number`	The source average sell price minus average buy price, documented only for all_time. Retain nulls and the original precision.
First-trade timestamp`result.entries[].first_trade_at`	`number`	The source Unix timestamp for the first trade, when provided. Seconds versus milliseconds is not specified; keep the original value.
Page information`result.pagination`	`object`	Pagination for this response. It does not include a total count of all matching wallets.
Returned wallet count`result.pagination.count`	`number`	The number of wallet records in this response, rather than a trade count or a count across every page.
Reported page limit`result.pagination.limit`	`number`	The page limit returned by the source. Documented requests allow an integer from 1 to 100, defaulting to 100.
More-records indicator`result.pagination.has_more`	`boolean`	The source indication that more records may follow. It does not establish an unchanged ranking or complete coverage.
Opaque continuation key`result.pagination.pagination_key`	`string`	A nullable key for continuing the same query. Preserve it unchanged rather than interpreting it as a wallet, page number or offset.

Additional notes

Compare the same window

The general first page needs no wallet address or market identifier. Optional window choices are 1d, 7d, 30d and all_time, defaulting to all_time. sort_by defaults to total_pnl and also supports realized_pnl, volume, roi, profit_factor, win_rate and trades; order defaults to desc and may be asc. A page limit is an integer from 1 to 100, defaulting to 100. The rolling windows do not define custom dates, a timezone or a refresh schedule.

Numeric min/max filters cover PnL, volume, trades, ROI, profit factor, win rate, average trade size, wallet age, average prices and entry edge. Use the documented units and bounds. style includes comma-separated labels with OR logic; exclude_style omits labels. The source does not fully define include/exclude interactions or every filter’s relationship to rolling windows.

Read amounts and rates together

Total PnL combines realized and unrealized PnL and subtracts net fees. Refunds are already netted into fees_paid, while fees_refunded is a deprecated zero placeholder. Trades and closed positions count different things; winning and losing positions need not account for every closed position. ROI and win rate are decimals, so 0.5 means 50%, but their denominators are not specified. Profit factor is gross profit divided by gross loss; its zero-loss convention is not defined. Preserve the reported values rather than rebuilding these ratios.

Average buy and sell prices are nullable volume-weighted values on the 0–1 scale, not current executable quotes or independently calibrated probabilities. entry_edge is the source average sell price minus average buy price, documented only for all_time. Its null value is not zero. The first_trade_at Unix timestamp has no explicit seconds or milliseconds unit in the matching documentation.

Labels and page context

Trading-style flags can overlap, while primary_style is a separate supplier-assigned label. Their calculation window and some threshold boundaries are not fully specified; the selected page does not justify reclassifying wallets or judging a person’s skill. A page count is separate from the entire ranked-wallet population, and continuation does not promise a frozen dataset.

The official leaderboard documentation explains the controls and metrics, with further context in the supplier’s trading-label guide. Follow the Toolmu connection guide when connecting your Agent.

Polymarket Wallet Leaderboard | BlockRun

Polymarket Wallet Leaderboard | BlockRun

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

Compare the same window

Read amounts and rates together

Labels and page context

Connect the AI assistant you use

See the standard Polymarket ranking

Understand the past results