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

Input
{
  "contractAddress": "0x5108d8c8efbd392ec093701d6215f580380d6d18",
  "page": 2,
  "pageSize": 2
}
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

input
{
  "contractAddress": "0x907997b2caf998617efe2d5f535427ff2c955629",
  "page": 2,
  "pageSize": 2
}
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

input
{
  "contractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
  "page": 2,
  "pageSize": 2
}
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