Skip to main content
GET
Get Position Top Holders
Get the largest holders of a single Polymarket CTF token (one outcome side of a market), ranked by position size. Use this when you have a specific token_id rather than a condition_id — for whole-market top holders across both Yes and No, use Market Top Holders.
Requires Dev or Pro tier. This endpoint is not available on the Free tier.

Pagination

Pass include_count=true to get the total holder count alongside the page. Use the pagination_key cursor from each response to fetch the next page.

Authorizations

x-api-key
string
header
required

Path Parameters

token_id
string
required

Polymarket CTF token ID

Query Parameters

include_count
boolean
default:false

Include total holder count

limit
integer
default:100

Results per page

Required range: 1 <= x <= 100
pagination_key
string | null

Cursor for pagination

Response

Successful Response

Response for market top holders endpoint.

condition_id
string
required

Market condition ID

entries
TopHolderEntry · object[]
required

Top holder entries

pagination
CursorPagination · object
required

Pagination info

title
string | null

Market title

market_slug
string | null

Market slug

side
string | null

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

total_count
integer | null

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