Returns list of wallets that hold a given token, ordered by holdings descending. Also has the unique count of holders for that token.
This endpoint is available on Codex Growth and Enterprise Plans
Endpoint: holders
The holders endpoint returns up to 50 wallets per request. To retrieve additional results beyond the first 50, use the cursor field for pagination.
Method: POST
Arguments
| Name | Type | Description |
|---|---|---|
| input | HoldersInput! | Required |
| Name | Type | Description |
|---|---|---|
| cursor | String | A cursor for use in pagination. |
| sort | HoldersInputSort | The attribute to sort the list on |
| tokenId | String! | The ID of the token ( |
Response
| Name | Type | Description |
|---|---|---|
| count | Int! | The unique count of holders for the token. |
| cursor | String | A cursor for use in pagination. |
| items | [Balance!] ! | The list of wallets holding the token. |
| status | HoldersStatus! | Status of holder. Disabled if on unsupported network or there is insufficient holder data. |
| top10HoldersPercent | Float | What percentage of the total supply do the top 10 holders hold. |
Explorer
Ask questions, share what you're working on and request new features 👬👭