Sign in

v1

latestOpenAPI 3.1.02026-07-2657157254.1 KB
polymarket
smart-wallet

Get Smart Activity Markets

Discover markets where high-performing wallets are active.

Use Case: Find alpha by seeing where profitable traders are putting their money.

How it works:

  1. Define "smart wallets" using the filter criteria (min_realized_pnl, min_total_pnl, min_roi, etc.)
  2. Find all markets these wallets have traded
  3. Rank markets by smart wallet activity (volume, count, realized PnL)

Filter Requirements:

At least one "strong" filter must meet configured minimum thresholds. Defaults in this service:

  • min_realized_pnl >= 5000 ($5,000+ PnL)
  • min_total_pnl >= 5000 ($5,000+ net total PnL)
  • min_roi >= 0.15 (15%+ ROI)
  • min_trades >= 100 (100+ trades)
  • min_volume >= 10000 ($10,000+ volume)

If using min_win_rate or min_profit_factor without a strong filter, you must also specify min_trades >= 50.

These requirements ensure meaningful wallet filtering and fast query performance.

Returns markets sorted by smart wallet activity metrics.

get/v2/polymarket/markets/smart-activity

Query parameters

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

Time window for rolling metrics.

Time window for metrics

sort_by'smart_volume' | 'smart_wallet_count' | 'smart_realized_pnl' | 'smart_total_pnl' | 'avg_smart_roi'

Sort options for smart activity markets.

Sort markets by this metric

order'asc' | 'desc'

Sort order direction enum.

Sort order

min_realized_pnlnumber nullable

Minimum global realized PnL to be 'smart' (USD)

Minimum global realized PnL to be 'smart' (USD)

min_total_pnlnumber nullable

Minimum global total PnL to be 'smart' (USD, net of fees)

Minimum global total PnL to be 'smart' (USD, net of fees)

min_roinumber nullable

Minimum global ROI to be 'smart' (decimal)

Minimum global ROI to be 'smart' (decimal)

min_win_ratenumber nullable

Minimum global win rate (decimal)

Minimum global win rate (decimal)

min_profit_factornumber nullable

Minimum global profit factor

Minimum global profit factor

min_tradesinteger nullable

Minimum global trade count

Minimum global trade count

min_volumenumber nullable

Minimum global volume (USD)

Minimum global volume (USD)

statusstring nullable

Filter by market status: open or closed

Filter by market status: open or closed

limitinteger

Results per page

Results per page

pagination_keystring nullable

Cursor for pagination

Cursor for pagination

Response

Successful Response

smart_wallet_criteriaobject required

Criteria used to define smart wallets

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

Time window for rolling metrics.