Sign in

v1

latestOpenAPI 3.1.02026-07-2657157254.1 KB
polymarket
smart-wallet

Get Smart Money Positioning

Get smart money positioning for a specific market.

Use Case: See what profitable traders are doing on a specific market.

Filter Requirements:

At least one "strong" filter must meet these minimum thresholds:

  • min_realized_pnl >= 1000 ($1,000+ PnL)
  • min_total_pnl >= 1000 ($1,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.

Returns:

  • How many smart wallets are net buyers vs net sellers
  • Average entry prices for smart wallets
  • Total volume and realized PnL from smart wallets
get/v2/polymarket/market/{condition_id}/smart-money

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 for metrics

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)

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.