Links

getTokenHolders

Get all token holders for the given ERC20 token contract address ordered descending by balance (supports snapshotting at a specific block number)

Parameters

  • contractAddress :(string) REQUIRED - The token contract address
  • blockNumber: (string) OPTIONAL - All holders at a specified block height
  • pageSize : (integer) OPTIONAL - Number of records to be retrieved on one page
  • pageKey : (string) OPTIONAL - Key used to get the next page of results. Must be set to the value of nextPageKey returned in the previous response

Returns

  • contractAddress: <string> - The token contract address
  • contractDecimals : <string> - Token decimals specified in the contract
  • contractName: <string> - The name of the token
  • contractSymbols: <string> - The ticker of the token
  • count : <integer> - The number of holders
  • nextPageKey: <string> - Key to get the next page of results, if more results are available
  • tokenHolders: <array> - The array of Token Holders details
    • walletAddress : <string> - The wallet address of the holder
    • balance: <string> - The token balance of the holder

Example Request and Result for getTokenHolders

Request
curl --location 'https://eth-mainnet.blastapi.io/<project-id>/builder/getTokenHolders?contractAddress=0xF411903cbC70a74d22900a5DE66A2dda66507255'
Result
{
"contractAddress": "0xf411903cbc70a74d22900a5de66a2dda66507255",
"contractDecimals": "18",
"contractName": "VERA",
"contractSymbol": "VRA",
"count": 100,
"nextPageKey": "ODlhNjdjODlmODY5OjE2OTg2Nzc4Mzg6MTQzMzk0MzM5ODYzNjM1NTg3MzQ0MTE2NDM6MHg4YmRkZmExMWEyOTIwNzNkNjhhOWU0YzYzOTYxYWFjZGE1OTcwZTgwOjE4NDYzNTYxOjE4OlZFUkE6VlJB",
"tokenHolders": [
{
"walletAddress": "0x40616cfec31a4449a1fc114a41fc3baa674cc00d",
"balance": "10866965381000000000000000000"
},
{
"walletAddress": "0xdeb0d30b07c62fe4f00aba9731489aac4c9cd4c3",
"balance": "10000000000000000000000000000"
},
{
"walletAddress": "0xa457fac91f96c2cb16a2550d8c337841388a1d33",
"balance": "10000000000000000000000000000"
},
{
"walletAddress": "0x9a55fae0ee20a909ba02c45f0904df9bb7ddd541",
"balance": "10000000000000000000000000000"
},
{
"walletAddress": "0x7709bb4f5ecc9d6e4752a4e1839a623a94946325",
"balance": "10000000000000000000000000000"
},
{
"walletAddress": "0x75af7b48e6dca542b7a51aa2513d4f73cfd863a3",
"balance": "10000000000000000000000000000"
},
{
"walletAddress": "0xd6216fc19db775df9774a6e33526131da7d19a2c",
"balance": "7124246287000000000000000000"
},
{
"walletAddress": "0x721029b39c90ffc7a64f2fe8ca6530e06afd4241",
"balance": "4740000000000000000000000000"
},
{
"walletAddress": "0xb8e6d31e7b212b2b7250ee9c26c56cebbfbe6b23",
"balance": "3341843885444651457890671327"
},
{
"walletAddress": "0xb4e07cec466005bfff0d241979c2f03b131ef1b1",
"balance": "2930000000000000000000000000"
},
{
"walletAddress": "0xf35a6bd6e0459a4b53a27862c51a2a7292b383d1",
"balance": "2323801734343981550919629824"
},
{
"walletAddress": "0xcffad3200574698b78f32232aa9d63eabd290703",
"balance": "1588003459586682097670019457"
},
{
"walletAddress": "0x6cc5f688a315f3dc28a7781717a9a798a59fda7b",
"balance": "633276362355979886046847051"
},
{
"walletAddress": "0x91dca37856240e5e1906222ec79278b16420dc92",
"balance": "498604624000000000000000000"
},
{
"walletAddress": "0x19184ab45c40c2920b0e0e31413b9434abd243ed",
"balance": "469199000000000000285212672"
},
{
"walletAddress": "0x7657c3f585bcf54e1d411ea2850a5d297129fe0a",
"balance": "459276045126372170693287669"
},
{
"walletAddress": "0xb8cbbf78c7ad1cdf4ca0e111b35491f3bfe027ac",
"balance": "448301879944700000000000000"
},
{
"walletAddress": "0x446b86a33e2a438f569b15855189e3da28d027ba",
"balance": "435218520501692765336472827"
},
{
"walletAddress": "0x3cc936b795a188f0e246cbb2d74c5bd190aecf18",
"balance": "401734513575974145182426858"
},
```