Returns the global Polymarket leaderboard of smart wallets ranked by total PnL, including per-trader metrics, trading styles, and performance statistics.
fetch-polymarket-leaderboardUse when an agent needs to identify top-performing Polymarket traders, compare realized PnL rankings, inspect win rates or profit factors, or analyze trading styles (whale, active trader, etc.) across the prediction market platform.
Do not use for individual trader lookup by address or for market-specific data; this endpoint returns only the global all-time leaderboard sorted by total PnL.
A verifier wallet pays the merchant and an AI grades what comes back.
windowstringTime window for the leaderboard (e.g. 'all_time').
all_timesort_bystringMetric used to sort the leaderboard (e.g. 'total_pnl').
total_pnlentriesarrayOrdered list of leaderboard entries, each containing rank, user wallet address, metrics, trading_styles, entry_edge, and first_trade_at.
[{"rank":1,"user":"0x56687bf447db6ffa42ffe2204a05edaa20f55839","metrics":{"realized_pnl":22053933.75,"total_pnl":22053933.75,"volume":20066524.36,"roi":1.099,"trades":16002,"wins":21,"losses":20,"win_rate":0.512,"profit_factor":185.98,"positions_closed":41,"avg_buy_price":0.522,"avg_sell_price":null,"fees_paid":0,"fees_refunded":0},"trading_styles":{"is_whale":true,"primary_style":"WHALE"},"entry_edge":null,"first_trade_at":1728918952}]entries[].rankintegerLeaderboard rank of the trader (1 = highest total PnL).
1entries[].userstringEthereum wallet address of the ranked trader.
0x56687bf447db6ffa42ffe2204a05edaa20f55839entries[].metricsobjectPerformance metrics including realized_pnl, total_pnl, volume, roi, trades, wins, losses, win_rate, profit_factor, positions_closed, avg_buy_price, avg_sell_price, fees_paid, fees_refunded.
entries[].trading_stylesobjectBoolean flags (is_whale, is_market_maker, is_active_trader, is_buy_and_hold, is_degen, is_high_conviction, is_contrarian, is_value_hunter) and a primary_style string.
entries[].entry_edgenumberNumeric edge score for the trader's entry timing; null if not available.
0.4453entries[].first_trade_atintegerUnix timestamp of the trader's first recorded trade.
1728918952GET https://blockrun.ai/api/v1/pm/polymarket/leaderboard
Drop this file into a Claude project, an Anthropic skill folder, or any agent framework that consumes SKILL.md format. The model reads it and knows when to invoke this paid endpoint.
# Polymarket Leaderboard
**Skill ID:** `fetch-polymarket-leaderboard`
**Endpoint:** `GET https://blockrun.ai/api/v1/pm/polymarket/leaderboard`
## Summary
Returns the global Polymarket leaderboard of smart wallets ranked by total PnL, including per-trader metrics, trading styles, and performance statistics.
## When to use
Use when an agent needs to identify top-performing Polymarket traders, compare realized PnL rankings, inspect win rates or profit factors, or analyze trading styles (whale, active trader, etc.) across the prediction market platform.
## Not for
Do not use for individual trader lookup by address or for market-specific data; this endpoint returns only the global all-time leaderboard sorted by total PnL.
## Returns
- **window** — string: Time window for the leaderboard (e.g. 'all_time').
- Example: `all_time`
- **sort_by** — string: Metric used to sort the leaderboard (e.g. 'total_pnl').
- Example: `total_pnl`
- **entries** — array: Ordered list of leaderboard entries, each containing rank, user wallet address, metrics, trading_styles, entry_edge, and first_trade_at.
- Example: `[{"rank":1,"user":"0x56687bf447db6ffa42ffe2204a05edaa20f55839","metrics":{"realized_pnl":22053933.75,"total_pnl":22053933.75,"volume":20066524.36,"roi":1.099,"trades":16002,"wins":21,"losses":20,"win_rate":0.512,"profit_factor":185.98,"positions_closed":41,"avg_buy_price":0.522,"avg_sell_price":null,"fees_paid":0,"fees_refunded":0},"trading_styles":{"is_whale":true,"primary_style":"WHALE"},"entry_edge":null,"first_trade_at":1728918952}]`
- **entries[].rank** — integer: Leaderboard rank of the trader (1 = highest total PnL).
- Example: `1`
- **entries[].user** — string: Ethereum wallet address of the ranked trader.
- Example: `0x56687bf447db6ffa42ffe2204a05edaa20f55839`
- **entries[].metrics** — object: Performance metrics including realized_pnl, total_pnl, volume, roi, trades, wins, losses, win_rate, profit_factor, positions_closed, avg_buy_price, avg_sell_price, fees_paid, fees_refunded.
- **entries[].trading_styles** — object: Boolean flags (is_whale, is_market_maker, is_active_trader, is_buy_and_hold, is_degen, is_high_conviction, is_contrarian, is_value_hunter) and a primary_style string.
- **entries[].entry_edge** — number: Numeric edge score for the trader's entry timing; null if not available.
- Example: `0.4453`
- **entries[].first_trade_at** — integer: Unix timestamp of the trader's first recorded trade.
- Example: `1728918952`
## Payment
This endpoint requires payment via the x402 protocol. Use a wallet that holds USDC on a chain the endpoint accepts.
https://blockrun.ai/api/v1/pm/polymarket/leaderboard