Skip to main content
GET
/
v2
/
polymarket
/
leaderboard
/
market
/
{condition_id}
Get Market Leaderboard
curl --request GET \
  --url https://api.predexon.com/v2/polymarket/leaderboard/market/{condition_id} \
  --header 'x-api-key: <api-key>'
{
  "condition_id": "<string>",
  "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>"
  }
}
Wallet rankings for trading performance within a single market. Filter by entry/sell prices, edge, and volume to find the best-performing traders on any market.
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

Path Parameters

​
condition_id
string
required

Market condition ID

Query Parameters

​
window
enum<string>
default:all_time

Time window

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
​
min_trades
integer | null

Minimum trades in this market

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

Minimum volume in this market

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 per-market leaderboard endpoint.

​
condition_id
string
required

Market condition ID

​
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