Skip to main content
GET
/
v2
/
polymarket
/
leaderboard
Get Leaderboard
curl --request GET \
  --url https://api.predexon.com/v2/polymarket/leaderboard \
  --header 'x-api-key: <api-key>'
{
  "window": "1d",
  "sort_by": "realized_pnl",
  "entries": [
    {
      "rank": 123,
      "user": "<string>",
      "metrics": {
        "realized_pnl": 123,
        "volume": 123,
        "roi": 123,
        "trades": 123,
        "wins": 123,
        "losses": 123,
        "win_rate": 123,
        "profit_factor": 123,
        "positions_closed": 123,
        "avg_buy_price": 123,
        "avg_sell_price": 123,
        "fees_paid": 0,
        "fees_refunded": 0
      },
      "trading_styles": {
        "is_whale": true,
        "is_market_maker": true,
        "is_active_trader": true,
        "is_buy_and_hold": true,
        "is_degen": true,
        "is_high_conviction": true,
        "is_contrarian": true,
        "is_value_hunter": true,
        "primary_style": "<string>"
      },
      "entry_edge": 123
    }
  ],
  "pagination": {
    "limit": 123,
    "count": 123,
    "has_more": true,
    "pagination_key": "<string>"
  }
}
Ranked list of wallets by trading performance. Supports filtering by trading style (WHALE, MARKET_MAKER, ACTIVE_TRADER, etc.), PnL range, minimum volume, win rate, and more.
Requires Dev or Pro tier. This endpoint is not available on the Free tier.
ConstraintValue
limit1–100 (default 100)

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
window
enum<string>
default:all_time

Time window for metrics

Available options:
1d,
7d,
30d,
all_time
​
sort_by
enum<string>
default:realized_pnl

Sort field

Available options:
realized_pnl,
volume,
roi,
profit_factor,
win_rate,
trades
​
order
enum<string>
default:desc

Sort order

Available options:
asc,
desc
​
style
string | null

Comma-separated styles to include (OR logic)

​
exclude_style
string | null

Comma-separated styles to exclude

​
min_realized_pnl
number | null

Minimum realized PnL in USD

​
max_realized_pnl
number | null

Maximum realized PnL in USD

​
min_volume
number | null

Minimum volume in USD

Required range: x >= 0
​
min_trades
integer | null

Minimum trade count

Required range: x >= 1
​
min_roi
number | null

Minimum ROI (decimal)

​
min_profit_factor
number | null

Minimum profit factor

Required range: x >= 0
​
min_win_rate
number | null

Minimum win rate (decimal)

Required range: 0 <= x <= 1
​
min_avg_trade_usd
number | null

Minimum avg trade size in USD

Required range: x >= 0
​
min_wallet_age_days
integer | null

Minimum wallet age in days

Required range: x >= 0
​
min_avg_buy_price
number | null

Minimum avg buy price (0-1)

Required range: 0 <= x <= 1
​
max_avg_buy_price
number | null

Maximum avg buy price (0-1)

Required range: 0 <= x <= 1
​
min_avg_sell_price
number | null

Minimum avg sell price (0-1)

Required range: 0 <= x <= 1
​
max_avg_sell_price
number | null

Maximum avg sell price (0-1)

Required range: 0 <= x <= 1
​
min_entry_edge
number | null

Minimum entry edge (avg_sell - avg_buy)

Required range: -1 <= x <= 1
​
max_entry_edge
number | null

Maximum entry edge (avg_sell - avg_buy)

Required range: -1 <= x <= 1
​
limit
integer
default:100

Results per page

Required range: 1 <= x <= 100
​
pagination_key
string | null

Cursor for pagination

Response

Successful Response

Response for global leaderboard endpoint.

​
window
enum<string>
required

Time window for metrics

Available options:
1d,
7d,
30d,
all_time
​
sort_by
enum<string>
required

Sort field used

Available options:
realized_pnl,
volume,
roi,
profit_factor,
win_rate,
trades
​
entries
LeaderboardEntry · object[]
required

Leaderboard entries

​
pagination
CursorPagination · object
required

Pagination info