Skip to main content
Retrieve a ranked list of traders on Polymarket. You can filter by time window, market category, and performance thresholds like minimum ROI or win rate to identify smart money and successful trading patterns across the platform. 
GET /v1/analytics/leaderboard
​
X-PolyEdge-Key
string
required
Your PolyEdge API key.

​
Parameters

​
limit
integer
default:"50"
Number of results to return. Maximum: 100.
Demo tier: maximum value is 20.
​
offset
integer
default:"0"
Pagination offset.
Demo tier: must be 0.
​
time_frame
string
default:"30D"
Time frame for ranking. Options: 1H, 4H, 1D, 3D, 7D, 30D.
​
sort_by
string
default:"pnl"
Field to sort results by. Options: pnl, roi, win_rate, market_count.
​
tag
string
default:"all"
Filter the leaderboard by a specific market tag. Options: all, sports, crypto, geopolitics, politics, finance, esports, pop-culture, tech, economy, weather, elections, tweets-markets, basketball, hockey, soccer, tennis, counter-strike-2, dota-2, league-of-legends, 5M, 15M.
The sports tag filters for traditional sports only and does not include esports data.
​
min_win_rate
float
Minimum win rate (0–100).
​
max_win_rate
float
Maximum win rate (0–100).
​
min_roi
float
Minimum ROI percentage.
​
max_roi
float
Maximum ROI percentage.
​
last_active_hours
integer
Filter to traders who have been active within the last N hours.
​
min_market_count
integer
Minimum number of markets traded.
​
max_market_count
integer
Maximum number of markets traded.
​
min_pnl
integer
Minimum PnL (USDC).

​
Response

​
traders
object[]
Array of ranked trader objects.
​
total_count
integer
Total number of traders matching the query. Use with limit and offset for pagination.

​
Example

curl https://api.polyedge.dev/v1/analytics/leaderboard?time_frame=7D&limit=5 \
  -H "X-PolyEdge-Key: YOUR_API_KEY"

{
  "traders": [
    {
      "profile": {
        "address": "0x50b1db131a24a9d9450bbd0372a95d32ea88f076",
        "name": "blindStaking",
        "profile_image": "",
        "x_username": "",
        "profile_created_at": "2026-03-12T19:53:36Z",
        "last_trade_at": "2026-04-05T01:00:55Z"
      },
      "total_pnl": "1620149290085",
      "total_volume": "2553211530521",
      "roi": 63.46,
      "win_rate": 50,
      "rank": 1,
      "markets_count": 4,
      "wins_count": 2
    },
    {
      "profile": {
        "address": "0xbddf61af533ff524d27154e589d2d7a81510c684",
        "name": "Countryside",
        "profile_image": "",
        "x_username": "",
        "profile_created_at": "2025-11-06T22:44:56Z",
        "last_trade_at": "2026-04-06T03:29:37Z"
      },
      "total_pnl": "782234111611",
      "total_volume": "3637703116635",
      "roi": 30.39,
      "win_rate": 40.43,
      "rank": 2,
      "markets_count": 47,
      "wins_count": 19
    },
    {
      "profile": {
        "address": "0x9f2fe025f84839ca81dd8e0338892605702d2ca8",
        "name": "surfandturf",
        "profile_image": "",
        "x_username": "",
        "profile_created_at": "2026-04-01T06:03:57Z",
        "last_trade_at": "2026-04-06T02:32:33Z"
      },
      "total_pnl": "639292755514",
      "total_volume": "2190632870982",
      "roi": 46.52,
      "win_rate": 61.54,
      "rank": 3,
      "markets_count": 26,
      "wins_count": 16
    },
    {
      "profile": {
        "address": "0x8a6c6811e8937f9e8afc1b9249fa540262c30b3f",
        "name": "0x8a6C6811e8937F9E8aFc1b9249FA540262c30b3f-1771776258725",
        "profile_image": "",
        "x_username": "",
        "profile_created_at": "2026-02-22T16:04:19Z",
        "last_trade_at": "2026-04-06T02:28:21Z"
      },
      "total_pnl": "607299024186",
      "total_volume": "3430098687485",
      "roi": 48.83,
      "win_rate": 60.87,
      "rank": 4,
      "markets_count": 46,
      "wins_count": 28
    },
    {
      "profile": {
        "address": "0x2b3ff45c91540e46fae1e0c72f61f4b049453446",
        "name": "Mentallyillgambld",
        "profile_image": "",
        "x_username": "",
        "profile_created_at": "2024-11-05T20:15:29Z",
        "last_trade_at": "2026-04-05T19:47:05Z"
      },
      "total_pnl": "421561636018",
      "total_volume": "835908056935",
      "roi": 50.43,
      "win_rate": 85.71,
      "rank": 5,
      "markets_count": 7,
      "wins_count": 6
    }
  ],
  "total_count": 202991
}