Token Holders
Returns the token holders wallets and token info ERC20, ERC721 and ERC1155 tokens.
GraphQL Query
query contractWallets($contractAddress: String!, $page: Int!, $pageSize: Int!) {
contractWallets(contractAddress: $contractAddress, page: $page, pageSize: $pageSize) {
walletAddresses {
address
amount
tokenId
}
contractAddress
name
symbol
latestPrice
netBalance
decimal
chain
tokenId
tokenType
}
}
Variables
{
"contractAddress": String, // Token Address
"page": Int, // Page Number
"pageSize": Int // Page Size
}
Response
{
"data": {
"contractWallets": {
"walletAddresses": Array<{
"address": String, // Token holders' wallet address
"amount": Float | null, // Token Balance in USD. Value null for ERC721 and ERC1155
"tokenId": String | null // Token Id. Value null for ERC20
}>,
"contractAddress": String, // Contract address of the token
"name": String, // Name of the token
"symbol": String, // Symbol of the token
"chain": String, // Blockchain network of the token
"tokenType": String // Token type
}
}
}
Example
ERC 1155
Output
{
"data": {
"contractWallets": {
"walletAddresses": [
{
"address": "0xfed1c02a1712e17d19fd66623f5ddf147d7d115d",
"amount": null,
"tokenId": "1"
},
{
"address": "0xfe6be326c89b85a82befad46a486e9169417d23e",
"amount": null,
"tokenId": "2"
}
],
"contractAddress": "0x5108d8c8efbd392ec093701d6215f580380d6d18",
"name": "P4L",
"symbol": "P4l",
"chain": "ETHEREUM",
"tokenType": "ERC1155"
}
}
}
ERC 721
Output
{
"data": {
"contractWallets": {
"walletAddresses": [
{
"address": "0xc655b560e61dfc2ec0d4ed4284a8b475e3563376",
"amount": null,
"tokenId": "125457"
},
{
"address": "0xc655b560e61dfc2ec0d4ed4284a8b475e3563376",
"amount": null,
"tokenId": "125456"
}
],
"contractAddress": "0x907997b2caf998617efe2d5f535427ff2c955629",
"name": "Chin Pokies",
"symbol": "POKIE",
"chain": "ETHEREUM",
"tokenType": "ERC721"
}
}
}
ERC 20
Output
{
"data": {
"contractWallets": {
"walletAddresses": [
{
"address": "0x47ac0fb4f2d84898e4d9e7b4dab3c24507a6d503",
"amount": 1419368215.4438286,
"tokenId": null
},
{
"address": "0x28c6c06298d514db089934071355e5743bf21d60",
"amount": 1324492229.679667,
"tokenId": null
}
],
"contractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"name": "Tether USD",
"symbol": "USDT",
"chain": "ETHEREUM",
"tokenType": "ERC20"
}
}
}
Last updated