Leaderboard
Top trader rankings and statistics
The Leaderboard API provides ranked lists of top traders with performance metrics. Data is sourced from Polymarket's leaderboard and enriched with position and trade data. All leaderboard endpoints are public.
Endpoints
| Method | Path | Auth | Description |
|---|---|---|---|
| GET | /api/v1/leaderboard | Public | Get leaderboard rankings |
| GET | /api/v1/leaderboard/biggest-wins | Public | Get biggest single-market wins |
| GET | /api/v1/leaderboard/:address | Public | Get trader profile by wallet address |
Get Leaderboard
Fetch a ranked list of traders with configurable sorting, filtering, and pagination.
Query Parameters:
| Parameter | Type | Default | Description |
|---|---|---|---|
tab | string | global | kol (verified traders only) or global (all traders) |
sort | string | pnl | Sort by: pnl, roi, winrate, volume, avgEntry, avgTrade, sharpeRatio, tradeCount |
sortDirection | string | desc | asc or desc |
period | string | 7D | Time period: 1D, 7D, 30D, ALL |
category | string | OVERALL | Market category: OVERALL, POLITICS, SPORTS, CRYPTO |
search | string | -- | Search by wallet address or display name |
cursor | string | -- | Cursor for pagination |
limit | number | 50 | Number of results (1-100) |
// GET /api/v1/leaderboard?tab=global&sort=pnl&period=7D&limit=5
// Response 200
{
"traders": [
{
"rank": 1,
"walletAddress": "0x1234...abcd",
"displayName": "TopTrader",
"avatarUrl": "https://...",
"isKol": true,
"pnl": 45200.50,
"roi": 32.5,
"winRate": 0.72,
"volume": 250000.00,
"tradeCount": 142,
"wins": 102,
"losses": 40,
"bestTrade": 12500.00,
"sharpeRatio": 2.1,
"sparkline": [0.45, 0.52, 0.48, 0.61, 0.63]
}
],
"nextCursor": "eyJyYW5rIjo1fQ=="
}Biggest Wins
Get the largest single-market winning trades for a given period.
Query Parameters:
| Parameter | Type | Default | Description |
|---|---|---|---|
period | string | 1D | Time period: 1D, 7D, 30D, ALL |
// GET /api/v1/leaderboard/biggest-wins?period=7D
// Response 200
[
{
"walletAddress": "0xabcd...1234",
"displayName": "WhaleTrader",
"marketTitle": "Will BTC reach $100K by April 2026?",
"pnl": 28500.00,
"side": "yes",
"entryPrice": 0.35,
"exitPrice": 0.92,
"resolvedAt": "2026-03-25T00:00:00.000Z"
}
]Trader Profile
Get detailed statistics and recent activity for a specific trader by wallet address.
// GET /api/v1/leaderboard/0x1234...abcd?period=30D
// Response 200
{
"walletAddress": "0x1234...abcd",
"displayName": "TopTrader",
"totalPnl": 45200.50,
"roi": 32.5,
"winRate": 0.72,
"totalTrades": 142,
"topPositions": [...],
"recentTrades": [...]
}Notes
- The KOL tab filters for verified traders (based on Polymarket's
verifiedBadgeflag) - Leaderboard data is synced from Polymarket every 10 minutes and enriched with detailed position data every 30 minutes
- The
sparklinearray contains recent PnL data points for rendering mini-charts - Trader profiles can be accessed by any wallet address, not just ranked traders