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"
        },
```