Get Token Top Holders

GET /tokens/{address}/top_holders

Path Parameters

string

required

Token contract address.

Query Parameters

string

required

Blockchain network where the token is deployed.

integer

Page number of the results to retrieve, starting from 1 .Default 1 Max 100 Min 1

integer

Number of records to return per page.Default: 50 Max: 100 Min: 10

Code Examples

# Replace with your actual API key from the DEXUtils platform
curl "https://api.dexutils.io/tokens/0x6982508145454ce325ddbe47a25d4ec3d2311933/top_holders?chain=ethereum&page=1&page_size=10" \
  -H "API-KEY: apikey"

import requests

# Replace with your actual API key from the DEXUtils platform
address = "0x6982508145454ce325ddbe47a25d4ec3d2311933"
url = f"https://api.dexutils.io/v1/tokens/{address}/top_holders"
headers = {"API-KEY": "apikey"}
params = {
	"chain": "ethereum",
	"page": 1,
	"page_size": 10,
}

response = requests.get(url, headers=headers, params=params)
res = response.json()

Response Fields

string

Wallet address of the holder.

integer

Holder’s rank by token balance.

float

Amount of tokens held by the wallet.

float

Estimated USD value of the token holdings.

Example Response

[
    {
        "wallet_address": "0xf977814e90da44bfa03b6295a0616a897441acec",
        "rank": 1,
        "token_balance": 36000000000000.0,
        "usd_value": 98811187.81649892
    },
    {
        "wallet_address": "0x5a52e96bacdabb82fd05763e25335261b270efcb",
        "rank": 2,
        "token_balance": 33023541724060.85,
        "usd_value": 90641538.43506014
    },
    {
        "wallet_address": "0x1d48963dd8fada6ab5c2c7b92eba81ecc5030270",
        "rank": 3,
        "token_balance": 28874092948935.883,
        "usd_value": 79252317.26134308
    },
    {
        "wallet_address": "0x3f9a8345729ea842708e080e238c92731e5699b8",
        "rank": 4,
        "token_balance": 14932046302242.71,
        "usd_value": 40984811.9904323
    },
    {
        "wallet_address": "0x611f7bf868a6212f871e89f7e44684045ddfb09d",
        "rank": 5,
        "token_balance": 13100277792438.535,
        "usd_value": 35957055.816582054
    },
    {
        "wallet_address": "0x15da7556d5ed888306839bed06f868aeaedcb0d7",
        "rank": 6,
        "token_balance": 9134237578624.023,
        "usd_value": 25071246.248387244
    },
    {
        "wallet_address": "0xc671b05671a7cd3080c6ceae79d284bdde0ef271",
        "rank": 7,
        "token_balance": 8988239773587.041,
        "usd_value": 24670518.01132319
    },
    {
        "wallet_address": "0x76ec5a0d3632b2133d9f1980903305b62678fbd3",
        "rank": 8,
        "token_balance": 7618942290365.344,
        "usd_value": 20912131.600454345
    },
    {
        "wallet_address": "0x000000000000000000000000000000000000dead",
        "rank": 9,
        "token_balance": 6917531765849.299,
        "usd_value": 18986931.40394257
    },
    {
        "wallet_address": "0xa023f08c70a23abc7edfc5b6b5e171d78dfc947e",
        "rank": 10,
        "token_balance": 6084193827000.069,
        "usd_value": 16699622.748657977
    }
]

Get Started

Endpoints

Guides

Get Token Top Holders

Path Parameters

Query Parameters

Code Examples

Response Fields

Example Response

​Path Parameters

​Query Parameters

​Code Examples

​Response Fields

​Example Response

Path Parameters

Query Parameters

Code Examples

Response Fields

Example Response