Developer Resources
Central Limit Order Book
Order Manipulation
Markets
Pricing and Books
Gamma Markets API
Miscellaneous Endpoints
Subgraph
Resolution
Rewards
Conditional Token Frameworks
Proxy Wallets
Negative Risk
Miscellaneous Endpoints
Get Market Holders (Data-API)
Fetches the top holders of a specified market token.
GET
/
holders
Copy
Ask AI
curl --request GET \
--url https://data-api.polymarket.com/holders
Copy
Ask AI
[
{
"token": "70018807773238020915361161897719073078804647330583488591369599275024",
"holders": [
{
"proxyWallet": "0xa59516996b5803e2b1ecb9df4db492c494743fde",
"bio": "",
"asset": "70018807773238020915361161897719073078804647330583488591369599275024",
"pseudonym": "Bossy-Figurine",
"amount": 215678.947713,
"displayUsernamePublic": true,
"outcomeIndex": 0,
"name": "ExampleGuy",
"profileImage": "",
"profileImageOptimized": ""
}
]
}
]
Query Parameters
The market (conditionId) to query.
Maximum number of holders to return. Defaults to 100.
Response
200 - application/json
A list of token holders
The response is of type object[]
.
Copy
Ask AI
curl --request GET \
--url https://data-api.polymarket.com/holders
Copy
Ask AI
[
{
"token": "70018807773238020915361161897719073078804647330583488591369599275024",
"holders": [
{
"proxyWallet": "0xa59516996b5803e2b1ecb9df4db492c494743fde",
"bio": "",
"asset": "70018807773238020915361161897719073078804647330583488591369599275024",
"pseudonym": "Bossy-Figurine",
"amount": 215678.947713,
"displayUsernamePublic": true,
"outcomeIndex": 0,
"name": "ExampleGuy",
"profileImage": "",
"profileImageOptimized": ""
}
]
}
]
Assistant
Responses are generated using AI and may contain mistakes.