Returns
Paginated list of holders for a token. See HoldersResponse.
Show View fields (HoldersResponse)
Show View fields (HoldersResponse)
Total count of holders.
Cursor for next page.
Whether holder data is enabled. See HoldersStatus.
Show HoldersStatus (enum)
Show HoldersStatus (enum)
Percentage held by top 10 holders.
Arguments
Token and pagination/sort options. See HoldersInput.
Show HoldersInput
Show HoldersInput
Token ID (e.g. tokenAddress:networkId).
Max number of holders to return.
Pagination cursor from previous response.
Sort order. See HoldersInputSort.
Show HoldersInputSort
Show HoldersInputSort
Field to sort by. See HoldersSortAttribute.
Show HoldersSortAttribute (enum)
Show HoldersSortAttribute (enum)
Sort direction. See RankingDirection.
Whether to exclude contract addresses from results.
Example
query Holders {
holders(input: {
tokenId: "0xdac17f958d2ee523a2206206994597c13d831ec7:1",
limit: 10,
sort: { attribute: BALANCE, direction: DESC }
}) {
count
cursor
status
top10HoldersPercent
items {
address
balance
shiftedBalance
balanceUsd
}
}
}