CoinMarketCap Cryptocurrency API Documentation

Holder

Token holder analytics and distribution data. This category includes 5 endpoints:

/v1/dex/holders/list - Get Holders List
/v1/dex/holders/detail - Get Holder Detail
/v1/dex/holders/trend/list - Get Holder Trend List
/v1/dex/holders/tag_count - Get Holder Tag Count
/v1/dex/holders/count - Get Holder Count

Get holders list

POST

https://pro-api.coinmarketcap.com

/v1/dex/holders/list

X-CMC_PRO_API_KEY (header)

Get detailed information for holders list

Available with no API key

Call this endpoint keyless - no API key, no signup. Prefix the path with /public-api: https://pro-api.coinmarketcap.com/public-api/v1/dex/holders/list. See the Keyless Public API for the full list, rate limits, and examples.

Get holders list › Headers

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Get holders list › Request Body

holders request

DqueryHoldersRequestDTO

tokenAddress

string

Token contract address

platform

string

Blockchain platform

tag

string

tag enum [tag_all, tag_kol, tag_smart_money, tag_whale, tag_bot, tag_sniper, tag_dev]

Get holders list › Responses

200

V1_DEX_Holders_List_-_Response_Model

HolderDexVO · required

API_Status_Object

Standardized status object for API calls.

POST/v1/dex/holders/list

curl https://pro-api.coinmarketcap.com/v1/dex/holders/list \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'X-CMC_PRO_API_KEY: <api-key>' \
  --data '{
  "tokenAddress": "0x1234567890abcdef1234567890abcdef12345678",
  "platform": "ethereum",
  "tag": "tag_all"
}'

Example Request Body

{
  "tokenAddress": "0x1234567890abcdef1234567890abcdef12345678",
  "platform": "ethereum",
  "tag": "tag_all"
}

json

Example Responses

{
  "data": {
    "holders": [
      {
        "blockHeight": "blockHeight",
        "firstActiveTime": "firstActiveTime",
        "netBuyAmount": "netBuyAmount",
        "realizedPnlPercent": "realizedPnlPercent",
        "spotPosition": "spotPosition",
        "buyVolume": "buyVolume",
        "sellVolume": "sellVolume",
        "buyUsd": "buyUsd",
        "sellUsd": "sellUsd",
        "buyCount": "buyCount",
        "sellCount": "sellCount",
        "avgBuyPriceUsd": "avgBuyPriceUsd",
        "avgSellPriceUsd": "avgSellPriceUsd",
        "realizedPnl": "realizedPnl",
        "actualBalance": "actualBalance",
        "price": "price",
        "walletAddress": "walletAddress",
        "tokenAddress": "tokenAddress",
        "platformId": 0,
        "percent": "percent",
        "balance": "balance",
        "totalSupply": "totalSupply",
        "tokenAccount": "tokenAccount",
        "logoUrl": "logoUrl",
        "name": "name",
        "publicName": "publicName",
        "tags": "tags",
        "addressExplorerUrl": "addressExplorerUrl",
        "symbol": "symbol",
        "nativeBalance": "nativeBalance",
        "fundingSource": "fundingSource",
        "fundingTime": "fundingTime",
        "lastActiveTime": "lastActiveTime",
        "walletCreateTime": 0,
        "spotOpenTs": "spotOpenTs",
        "spotClearanceTs": "spotClearanceTs",
        "tokenLogo": "tokenLogo",
        "tokenSymbol": "tokenSymbol",
        "platformCryptoId": 0,
        "dexerPlatformName": "dexerPlatformName",
        "lowLiquidityFlag": 0,
        "memePumpInnerFlag": 0,
        "blackListFlag": 0,
        "stableCoinFlag": 0,
        "riskLevelFlag": 0
      }
    ]
  },
  "status": {
    "timestamp": "2026-03-05T22:43:48.471Z",
    "error_code": 0,
    "error_message": "",
    "elapsed": 10,
    "credit_count": 1,
    "notice": "",
    "total_count": 8128
  }
}

json

application/json

Get holder detail

POST

https://pro-api.coinmarketcap.com

/v1/dex/holders/detail

X-CMC_PRO_API_KEY (header)

Get detailed information for holders detail

Available with no API key

Call this endpoint keyless - no API key, no signup. Prefix the path with /public-api: https://pro-api.coinmarketcap.com/public-api/v1/dex/holders/detail. See the Keyless Public API for the full list, rate limits, and examples.

Get holder detail › Headers

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Get holder detail › Request Body

holders detail request

DqueryHoldersDetailRequestDTO

tokenAddress

string

Token contract address

walletAddress

string

Wallet address

platform

string

Blockchain platform

tag

string

tag enum [tag_all, tag_kol, tag_smart_money, tag_whale, tag_bot, tag_sniper, tag_dev]

Get holder detail › Responses

200

V1_DEX_Holders_Detail_-_Response_Model

HolderDetailVO · required

API_Status_Object

Standardized status object for API calls.

POST/v1/dex/holders/detail

curl https://pro-api.coinmarketcap.com/v1/dex/holders/detail \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'X-CMC_PRO_API_KEY: <api-key>' \
  --data '{
  "tokenAddress": "0x1234567890abcdef1234567890abcdef12345678",
  "walletAddress": "0xabcdef1234567890abcdef1234567890abcdef12",
  "platform": "ethereum",
  "tag": "tag_all"
}'

Example Request Body

{
  "tokenAddress": "0x1234567890abcdef1234567890abcdef12345678",
  "walletAddress": "0xabcdef1234567890abcdef1234567890abcdef12",
  "platform": "ethereum",
  "tag": "tag_all"
}

json

Example Responses

{
  "data": {
    "blockHeight": "blockHeight",
    "firstActiveTime": "firstActiveTime",
    "netBuyAmount": "netBuyAmount",
    "realizedPnlPercent": "realizedPnlPercent",
    "spotPosition": "spotPosition",
    "buyVolume": "buyVolume",
    "sellVolume": "sellVolume",
    "buyUsd": "buyUsd",
    "sellUsd": "sellUsd",
    "buyCount": "buyCount",
    "sellCount": "sellCount",
    "avgBuyPriceUsd": "avgBuyPriceUsd",
    "avgSellPriceUsd": "avgSellPriceUsd",
    "realizedPnl": "realizedPnl",
    "actualBalance": "actualBalance",
    "price": "price",
    "walletAddress": "walletAddress",
    "tokenAddress": "tokenAddress",
    "platformId": 0,
    "percent": "percent",
    "balance": "balance",
    "totalSupply": "totalSupply",
    "tokenAccount": "tokenAccount",
    "logoUrl": "logoUrl",
    "name": "name",
    "publicName": "publicName",
    "tags": "tags",
    "addressExplorerUrl": "addressExplorerUrl",
    "symbol": "symbol",
    "nativeBalance": "nativeBalance",
    "fundingSource": "fundingSource",
    "fundingTime": "fundingTime",
    "lastActiveTime": "lastActiveTime",
    "walletCreateTime": 0,
    "spotOpenTs": "spotOpenTs",
    "spotClearanceTs": "spotClearanceTs",
    "tokenLogo": "tokenLogo",
    "tokenSymbol": "tokenSymbol",
    "platformCryptoId": 0,
    "dexerPlatformName": "dexerPlatformName",
    "lowLiquidityFlag": 0,
    "memePumpInnerFlag": 0,
    "blackListFlag": 0,
    "stableCoinFlag": 0,
    "riskLevelFlag": 0
  },
  "status": {
    "timestamp": "2026-03-05T22:43:48.471Z",
    "error_code": 0,
    "error_message": "",
    "elapsed": 10,
    "credit_count": 1,
    "notice": "",
    "total_count": 8128
  }
}

json

application/json

Get holder trend list

GET

https://pro-api.coinmarketcap.com

/v1/dex/holders/trend/list

X-CMC_PRO_API_KEY (header)

Get detailed information for holders trend list

Get holder trend list › query Parameters

platform

string

Platform name or id

tokenAddress

string

Token address

interval

string

Kline interval: 1d

from

integer · int64

start timestamp

to

integer · int64

End timestamp

limit

integer · int32

Number of to load

Get holder trend list › Headers

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Get holder trend list › Responses

200

V1_DEX_Holders_Trend_List_-_Response_Model

HolderTrendVO[] · required

API_Status_Object

Standardized status object for API calls.

GET/v1/dex/holders/trend/list

curl https://pro-api.coinmarketcap.com/v1/dex/holders/trend/list \
  --header 'X-CMC_PRO_API_KEY: <api-key>'

Example Responses

{
  "data": [
    {
      "ts": "ts",
      "endTs": "endTs",
      "platform": 0,
      "tokenAddress": "tokenAddress",
      "holders": "holders",
      "holdingRatioOfTop100": "holdingRatioOfTop100",
      "holdingRatioOfTop50": "holdingRatioOfTop50",
      "holdingRatioOfTop10": "holdingRatioOfTop10",
      "totalBalanceOfTop100": "totalBalanceOfTop100",
      "totalBalanceOfTop50": "totalBalanceOfTop50",
      "totalBalanceOfTop10": "totalBalanceOfTop10",
      "biggerThan10DHolders": "biggerThan10DHolders",
      "avgBalanceAllHolders": "avgBalanceAllHolders",
      "avgBalanceOfTop100": "avgBalanceOfTop100",
      "avgPositionCostOfTop100": "avgPositionCostOfTop100",
      "avgSellPriceOfTop100": "avgSellPriceOfTop100",
      "tagHolder": "tagHolder",
      "avgBalanceUSDAllHolders": "avgBalanceUSDAllHolders",
      "avgBalanceUSDOfTop100": "avgBalanceUSDOfTop100",
      "tagHolderTTHM": "tagHolderTTHM",
      "price": "price"
    }
  ],
  "status": {
    "timestamp": "2026-03-05T22:43:48.471Z",
    "error_code": 0,
    "error_message": "",
    "elapsed": 10,
    "credit_count": 1,
    "notice": "",
    "total_count": 8128
  }
}

json

application/json

Get holder tag count

GET

https://pro-api.coinmarketcap.com

/v1/dex/holders/tag_count

X-CMC_PRO_API_KEY (header)

Get detailed information for holders tag count

Get holder tag count › query Parameters

platform

string · required

tokenAddress

string · required

Get holder tag count › Headers

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Get holder tag count › Responses

200

V1_DEX_Holders_Tag_Count_-_Response_Model

HolderTagCountVO · required

API_Status_Object

Standardized status object for API calls.

Get holder count

GET

https://pro-api.coinmarketcap.com

/v1/dex/holders/count

X-CMC_PRO_API_KEY (header)

Get detailed information for holders count

Available with no API key

Call this endpoint keyless - no API key, no signup. Prefix the path with /public-api: https://pro-api.coinmarketcap.com/public-api/v1/dex/holders/count. See the Keyless Public API for the full list, rate limits, and examples.

Get holder count › query Parameters

platform

string · required

tokenAddress

string · required

Get holder count › Headers

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Get holder count › Responses

200

V1_DEX_Holders_Count_-_Response_Model

HolderCountVO · required

API_Status_Object

Standardized status object for API calls.

Platform OHLCV

Get holders list

POST

https://pro-api.coinmarketcap.com

/v1/dex/holders/list

X-CMC_PRO_API_KEY (header)

Get detailed information for holders list

Available with no API key

Get holders list › Headers

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Get holders list › Request Body

holders request

DqueryHoldersRequestDTO

tokenAddress

string

Token contract address

platform

string

Blockchain platform

tag

string

tag enum [tag_all, tag_kol, tag_smart_money, tag_whale, tag_bot, tag_sniper, tag_dev]

Get holders list › Responses

200

V1_DEX_Holders_List_-_Response_Model

HolderDexVO · required

API_Status_Object

Standardized status object for API calls.

Get holder detail

POST

https://pro-api.coinmarketcap.com

/v1/dex/holders/detail

X-CMC_PRO_API_KEY (header)

Get detailed information for holders detail

Available with no API key

Get holder detail › Headers

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Get holder detail › Request Body

holders detail request

DqueryHoldersDetailRequestDTO

tokenAddress

string

Token contract address

walletAddress

string

Wallet address

platform

string

Blockchain platform

tag

string

tag enum [tag_all, tag_kol, tag_smart_money, tag_whale, tag_bot, tag_sniper, tag_dev]

Get holder detail › Responses

200

V1_DEX_Holders_Detail_-_Response_Model

HolderDetailVO · required

API_Status_Object

Standardized status object for API calls.

Get holder trend list

GET

https://pro-api.coinmarketcap.com

/v1/dex/holders/trend/list

X-CMC_PRO_API_KEY (header)

Get detailed information for holders trend list

Get holder trend list › query Parameters

platform

string

Platform name or id

tokenAddress

string

Token address

interval

string

Kline interval: 1d

from

integer · int64

start timestamp

to

integer · int64

End timestamp

limit

integer · int32

Number of to load

Get holder trend list › Headers

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Get holder trend list › Responses

200

V1_DEX_Holders_Trend_List_-_Response_Model

HolderTrendVO[] · required

API_Status_Object

Standardized status object for API calls.

Get holder tag count

GET

https://pro-api.coinmarketcap.com

/v1/dex/holders/tag_count

X-CMC_PRO_API_KEY (header)

Get detailed information for holders tag count

Get holder tag count › query Parameters

platform

string · required

tokenAddress

string · required

Get holder tag count › Headers

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Get holder tag count › Responses

200

V1_DEX_Holders_Tag_Count_-_Response_Model

HolderTagCountVO · required

API_Status_Object

Standardized status object for API calls.

Get holder count

GET

https://pro-api.coinmarketcap.com

/v1/dex/holders/count

X-CMC_PRO_API_KEY (header)

Get detailed information for holders count

Available with no API key

Get holder count › query Parameters

platform

string · required

tokenAddress

string · required

Get holder count › Headers

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Get holder count › Responses

200

V1_DEX_Holders_Count_-_Response_Model

HolderCountVO · required

API_Status_Object

Standardized status object for API calls.