GET/holders

Get top holders for markets

**Data API v2:** this route has a v2 counterpart, `GET /v2/holders`. See [Migrating to Data API v2](/migrate/data-api-v1-to-v2).

Base URL: https://data-api.polymarket.com
Auth: Public, no key
Rate limit: 1,000 req / 10s (100 per second)
Limit applies to: Data API general

Things to know

Data API v1 has been frozen since 4 September 2026. It still answers, but new fields and endpoints only go to v2. The v2 version of this call is GET /v2/holders.

Parameters

Name	In	Type	Required	Description
limit	query	integer	no	Maximum number of holders to return per token. Capped at 20.
market	query	object[]	yes	Comma-separated list of condition IDs.
minBalance	query	integer	no

Example

curl -X GET "https://data-api.polymarket.com/holders?market=<market>"

Returns a list of objects with these fields

Field	Type	Description
token	string
holders	object[]

Responses

Status	Meaning
200	Success
400	Bad Request
401	Unauthorized
500	Server Error

Related endpoints

GET /v2/holders Data API v2

Polymarket's API serves current state only, so it cannot show what a market's book looked like after it resolved. PolyTest records Up/Down markets while they run and keeps the snapshots. Try it free, or read the full rate limit reference.

From Polymarket's published OpenAPI spec and rate-limit tables, synced 2026-10-04.