Get Market Top Holders
Smart Money & Leaderboards
Market Top Holders
Top holders for a specific market ranked by position size
GET
Get Market Top Holders
Get the largest position holders in any market. Use the
side parameter to filter by Yes or No holders and see their position value, entry price, and PnL.
Requires Dev or Pro tier. This endpoint is not available on the Free tier.
| Constraint | Value |
|---|---|
limit | 1–100 (default 100) |
Authorizations
Path Parameters
Market condition ID
Query Parameters
Filter by position side: 'yes' or 'no'
Pattern:
^(yes|no)$Minimum shares held (normalized)
Required range:
x >= 0Minimum number of trades
Required range:
x >= 1Include total holder count (slower query)
Results per page
Required range:
1 <= x <= 100Cursor for pagination
Response
Successful Response
Response for market top holders endpoint.
Market condition ID
Top holder entries
Pagination info
Market title
Market slug
Position side filter applied ('yes', 'no', or null for all)
Total number of holders matching filters (only if include_count=true)
