Sign in

v1

latestOpenAPI 3.1.02026-07-2657157254.1 KB
polymarket
smart-wallet

Get Market Top Holders

Get top holders for a specific market, ranked by position size.

Use the 'side' parameter to filter by Yes or No holders:

  • side=yes: Top holders betting on Yes outcome
  • side=no: Top holders betting on No outcome

Returns wallets with the largest positions in this market, including their position value, entry price, and realized/unrealized PnL.

get/v2/polymarket/market/{condition_id}/top-holders

Path parameters

condition_idstring required

Market condition ID

Market condition ID

Query parameters

sidestring nullable

Filter by position side: 'yes' or 'no'

Filter by position side: 'yes' or 'no'

min_sharesnumber nullable

Minimum shares held (normalized)

Minimum shares held (normalized)

min_tradesinteger nullable

Minimum number of trades

Minimum number of trades

include_countboolean

Include total holder count (slower query)

Include total holder count (slower query)

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

titlestring nullable

Market title

market_slugstring nullable

Market slug

sidestring nullable

Position side filter applied ('yes', 'no', or null for all)

total_countinteger nullable

Total number of holders matching filters (only if include_count=true)