Top Traders PnL Leaderboard

Queries ranked traders across timeframes (1H, 4H, 1D, 3D, 7D, 30D) with optional filters

GEThttps://api.polyedge.dev/v2/analytics/leaderboard

Request Parameters

Required headers and parameter specifications for this endpoint.

Headers

Header	Type	Required	Description
X-PolyEdge-Key	string	required	PolyEdge API Key for client authentication and rate-limiting

Query Parameters

Parameter	Type	Default	Description
time_frame	string	30D	Time window (1H, 4H, 1D, 3D, 7D, 30D) Options:`1H4H1D3D7D30D`
sort_by	string	pnl	Ranking metric Options:`pnlroiwin_ratemarket_count`
tag	string	all	Market category tag slug Options:`allsportscryptogeopoliticspoliticsfinanceesportspop-culturetecheconomyweatherelectionstweets-marketsbasketballbaseballhockeysoccertenniscounter-strike-2dota-2league-of-legends5M15M`
limit	integer	50	Number of traders to return (1-100)
offset	integer	0	Offset for pagination
min_win_rate	number	-	Minimum win rate filter (0.0 - 100.0)
max_win_rate	number	-	Maximum win rate filter (0.0 - 100.0)
min_roi	number	-	Minimum ROI percentage filter
max_roi	number	-	Maximum ROI percentage filter
min_pnl	integer	-	Minimum realized PnL in whole USD (e.g. 100 for $100)
min_market_count	integer	-	Minimum resolved prediction markets traded
max_market_count	integer	-	Maximum resolved prediction markets traded
last_active_hours	integer	-	Filter traders active within the last N hours

Response (200 OK)

Field definitions for the successful response payload.

application/json

200 Response Example

json

{
  "total_count": 285870,
  "traders": [
    {
      "last_trade_at": "2026-09-29T11:45:20Z",
      "markets_count": 8,
      "profile": {
        "address": "0x51698a47f840a242abc2ca0351371c7ffac41842",
        "name": "00gringo00",
        "profile_created_at": "2026-09-08T15:59:59.000456Z",
        "profile_image": "",
        "x_username": ""
      },
      "rank": 1,
      "roi": 39.3,
      "total_pnl": 3506448469791,
      "total_volume": 21496644851334,
      "win_rate": 75,
      "wins_count": 6
    },
    {
      "last_trade_at": "2026-09-29T10:30:15Z",
      "markets_count": 4,
      "profile": {
        "address": "0x34dd4a4b70eaf79a17878f7938263c801d4dfd83",
        "name": "vito3corleone",
        "profile_created_at": "2026-06-02T16:07:44.897031Z",
        "profile_image": "",
        "x_username": ""
      },
      "rank": 2,
      "roi": 45.92,
      "total_pnl": 2505328770658,
      "total_volume": 5455745044758,
      "win_rate": 75,
      "wins_count": 3
    },
    {
      "last_trade_at": "2026-09-29T09:12:44Z",
      "markets_count": 31,
      "profile": {
        "address": "0x3a8aa345d5db7ec5138298c8c4f4540259be7699",
        "name": "TheReturnOfDarthMaul",
        "profile_created_at": "2026-02-09T18:01:48.41788Z",
        "profile_image": "",
        "x_username": ""
      },
      "rank": 3,
      "roi": 56.93,
      "total_pnl": 2297823520021,
      "total_volume": 4908383466628,
      "win_rate": 22.58,
      "wins_count": 7
    },
    {
      "last_trade_at": "2026-09-29T08:55:01Z",
      "markets_count": 112,
      "profile": {
        "address": "0x924379a79c64b77ad5816ad362122a5f6228658e",
        "name": "Kch-Temp",
        "profile_created_at": "2026-06-09T14:33:14.162757Z",
        "profile_image": "",
        "x_username": ""
      },
      "rank": 4,
      "roi": 34.59,
      "total_pnl": 1657970715706,
      "total_volume": 4792850764875,
      "win_rate": 58.04,
      "wins_count": 65
    },
    {
      "last_trade_at": "2026-09-29T07:20:18Z",
      "markets_count": 22,
      "profile": {
        "address": "0x0f6f76ced62a911bccef92f50faaff143854d977",
        "name": "totoro3miyazaki",
        "profile_created_at": "2026-06-02T16:29:07.176962Z",
        "profile_image": "",
        "x_username": ""
      },
      "rank": 5,
      "roi": 12.27,
      "total_pnl": 1448310062160,
      "total_volume": 11802552670151,
      "win_rate": 63.64,
      "wins_count": 14
    },
    {
      "last_trade_at": "2026-09-29T06:14:52Z",
      "markets_count": 229,
      "profile": {
        "address": "0xf0318c32136c2db7fec88b84869aee6a1106c80c",
        "name": "BreakTheBank",
        "profile_created_at": "2026-01-22T23:17:23.396976Z",
        "profile_image": "",
        "x_username": ""
      },
      "rank": 6,
      "roi": 7.48,
      "total_pnl": 1345717232573,
      "total_volume": 19163479219463,
      "win_rate": 51.09,
      "wins_count": 117
    },
    {
      "last_trade_at": "2026-09-29T05:40:33Z",
      "markets_count": 2716,
      "profile": {
        "address": "0x224a89dbe0db0d6124b335edabd15b3f877da3d5",
        "name": "wr0ngw4yb3tt0r",
        "profile_created_at": "2026-05-23T14:04:09.757757Z",
        "profile_image": "",
        "x_username": ""
      },
      "rank": 7,
      "roi": 2.91,
      "total_pnl": 1138289733705,
      "total_volume": 47764283496108,
      "win_rate": 49.89,
      "wins_count": 1355
    },
    {
      "last_trade_at": "2026-09-29T04:25:10Z",
      "markets_count": 44,
      "profile": {
        "address": "0xd570e634aeb745d6501566dba5f81a555cc7e4f8",
        "name": "0xd9670ea74384c1e1b9dc1e4267ffadaf4cdd140",
        "profile_created_at": "2025-02-19T19:52:35.560036Z",
        "profile_image": "",
        "x_username": ""
      },
      "rank": 8,
      "roi": 31.88,
      "total_pnl": 1115333726924,
      "total_volume": 3518552590837,
      "win_rate": 70.45,
      "wins_count": 31
    },
    {
      "last_trade_at": "2026-09-29T03:18:27Z",
      "markets_count": 27,
      "profile": {
        "address": "0xcbc666209b4c17ea84c03c0dda71b5dab9e4ec62",
        "name": "raybanman",
        "profile_created_at": "2026-06-11T10:26:42.793861Z",
        "profile_image": "",
        "x_username": ""
      },
      "rank": 9,
      "roi": 26.52,
      "total_pnl": 1058403007250,
      "total_volume": 4097927726724,
      "win_rate": 59.26,
      "wins_count": 16
    },
    {
      "last_trade_at": "2026-09-29T02:05:49Z",
      "markets_count": 3,
      "profile": {
        "address": "0x14c7111afa871fb215339f365043d7b2837b9ccf",
        "name": "kilian7kilian",
        "profile_created_at": "2026-08-25T16:21:13.802491Z",
        "profile_image": "",
        "x_username": ""
      },
      "rank": 10,
      "roi": 80.08,
      "total_pnl": 966081810934,
      "total_volume": 3406163050709,
      "win_rate": 66.67,
      "wins_count": 2
    }
  ]
}

Response Body Fields

Field	Type	Description
total_count	integer	Total count of matching traders for pagination
traders	array of objects	Ranked array of trader performance summaries
├─last_trade_at	string	ISO 8601 UTC timestamp of trader's most recent trade across the platform
├─markets_count	integer	Number of distinct prediction markets traded in timeframe
├─profile	object	-
├─address	string	Checksummed 0x-prefixed EVM wallet address
├─name	string	Custom display name or Polymarket profile username
├─profile_created_at	string	ISO 8601 UTC timestamp of Polymarket profile creation
├─profile_image	string	Public avatar image URL
├─x_username	string	Linked X (formerly Twitter) social handle
├─rank	integer	Leaderboard ranking position (1-based)
├─roi	number	Return on investment percentage over timeframe (e.g. 25.5 for 25.5%)
├─total_pnl	integer	Realized net profit and loss in micro-USD (6 decimals, e.g. 1000000 = 1 USD)
├─total_volume	integer	Aggregated trading volume in micro-USD (6 decimals)
├─win_rate	number	Percentage of profitable closed positions (0.0 to 100.0)
├─wins_count	integer	Number of profitable settled markets in timeframe

cURL Example

Copy and run this command directly in your terminal to test this endpoint.

cURL: GET /v2/analytics/leaderboard

bash

curl -X GET "https://api.polyedge.dev/v2/analytics/leaderboard?time_frame=30D&sort_by=pnl&tag=all&limit=50&offset=0" \
  -H "X-PolyEdge-Key: Your-PolyEdge-ApiKey"