Polymarket Leaderboard

# 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.