v1

latestOpenAPI 3.1.02026-07-2657157254.1 KB
polymarket
smart-wallet

Get Market Leaderboard

Get leaderboard for a specific market.

Shows wallet rankings for trading performance within a single market.

get/v2/polymarket/leaderboard/market/{condition_id}

Path parameters

condition_idstring required

Market condition ID

Market condition ID

Query parameters

window'1d' | '7d' | '30d' | 'all_time'

Time window for rolling metrics.

Time window

sort_by'realized_pnl' | 'total_pnl' | 'volume' | 'roi' | 'profit_factor' | 'win_rate' | 'trades'

Sort options for leaderboard.

Sort field

order'asc' | 'desc'

Sort order direction enum.

Sort order

min_total_pnlnumber nullable

Minimum total PnL in this market (USD, net of fees)

Minimum total PnL in this market (USD, net of fees)

max_total_pnlnumber nullable

Maximum total PnL in this market (USD, net of fees)

Maximum total PnL in this market (USD, net of fees)

min_tradesinteger nullable

Minimum trades in this market

Minimum trades in this market

max_tradesinteger nullable

Maximum trades in this market

Maximum trades in this market

min_volumenumber nullable

Minimum volume in this market

Minimum volume in this market

max_volumenumber nullable

Maximum volume in this market

Maximum volume in this market

min_avg_buy_pricenumber nullable

Minimum avg buy price (0-1)

Minimum avg buy price (0-1)

max_avg_buy_pricenumber nullable

Maximum avg buy price (0-1)

Maximum avg buy price (0-1)

min_avg_sell_pricenumber nullable

Minimum avg sell price (0-1)

Minimum avg sell price (0-1)

max_avg_sell_pricenumber nullable

Maximum avg sell price (0-1)

Maximum avg sell price (0-1)

min_entry_edgenumber nullable

Minimum entry edge (avg_sell - avg_buy)

Minimum entry edge (avg_sell - avg_buy)

max_entry_edgenumber nullable

Maximum entry edge (avg_sell - avg_buy)

Maximum entry edge (avg_sell - avg_buy)

limitinteger

Results per page

Results per page

pagination_keystring nullable

Cursor for pagination

Cursor for pagination

Response

Successful Response

condition_idstring required

Market condition ID

window'1d' | '7d' | '30d' | 'all_time' required

Time window for rolling metrics.

sort_by'realized_pnl' | 'total_pnl' | 'volume' | 'roi' | 'profit_factor' | 'win_rate' | 'trades' required

Sort options for leaderboard.