CoinMarketCap Cryptocurrency API Documentation

Holder

Endpointhttps://pro-api.coinmarketcap.com

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

Get detailed information for holders list

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

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

object[]

POST/v1/dex/holders/list

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

shell

Example Request Body

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

json

Example Responses

{
  "holders": [
    {
      "blockHeight": 0,
      "firstActiveTime": 0,
      "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": 0,
      "lastActiveTime": 0,
      "walletCreateTime": 0,
      "spotOpenTs": 0,
      "spotClearanceTs": 0,
      "tokenLogo": "tokenLogo",
      "tokenSymbol": "tokenSymbol",
      "platformCryptoId": 0,
      "dexerPlatformName": "dexerPlatformName",
      "lowLiquidityFlag": 0,
      "memePumpInnerFlag": 0,
      "blackListFlag": 0,
      "stableCoinFlag": 0,
      "riskLevelFlag": 0
    }
  ]
}

text

application/octet-stream

Get holder detail

POST

https://pro-api.coinmarketcap.com

/v1/dex/holders/detail

Get detailed information for holders detail

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

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

blockHeight

integer · int64

firstActiveTime

integer · int64

netBuyAmount

string

realizedPnlPercent

string

spotPosition

string

buyVolume

string

sellVolume

string

buyUsd

string

sellUsd

string

buyCount

string

sellCount

string

avgBuyPriceUsd

string

avgSellPriceUsd

string

realizedPnl

string

actualBalance

string

price

string

walletAddress

string

tokenAddress

string

platformId

integer · int32

percent

string

balance

string

totalSupply

string

tokenAccount

string

logoUrl

string

name

string

publicName

string

tags

string

addressExplorerUrl

string

symbol

string

nativeBalance

string

fundingSource

string

fundingTime

integer · int64

lastActiveTime

integer · int64

walletCreateTime

integer · int64

spotOpenTs

integer · int64

spotClearanceTs

integer · int64

tokenLogo

string

tokenSymbol

string

platformCryptoId

integer · int32

dexerPlatformName

string

lowLiquidityFlag

integer · int32

memePumpInnerFlag

integer · int32

blackListFlag

integer · int32

stableCoinFlag

integer · int32

riskLevelFlag

integer · int32

POST/v1/dex/holders/detail

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

shell

Example Request Body

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

json

Example Responses

{
  "blockHeight": 0,
  "firstActiveTime": 0,
  "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": 0,
  "lastActiveTime": 0,
  "walletCreateTime": 0,
  "spotOpenTs": 0,
  "spotClearanceTs": 0,
  "tokenLogo": "tokenLogo",
  "tokenSymbol": "tokenSymbol",
  "platformCryptoId": 0,
  "dexerPlatformName": "dexerPlatformName",
  "lowLiquidityFlag": 0,
  "memePumpInnerFlag": 0,
  "blackListFlag": 0,
  "stableCoinFlag": 0,
  "riskLevelFlag": 0
}

text

application/octet-stream

Get holder trend list

GET

https://pro-api.coinmarketcap.com

/v1/dex/holders/trend/list

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

object[]

ts

integer · int64

endTs

integer · int64

platform

integer · int32

tokenAddress

string

holders

integer · int64

holdingRatioOfTop100

string

holdingRatioOfTop50

string

holdingRatioOfTop10

string

totalBalanceOfTop100

string

totalBalanceOfTop50

string

totalBalanceOfTop10

string

biggerThan10DHolders

integer · int64

avgBalanceAllHolders

string

avgBalanceOfTop100

string

avgPositionCostOfTop100

string

avgSellPriceOfTop100

string

tagHolder

string

avgBalanceUSDAllHolders

string

avgBalanceUSDOfTop100

string

tagHolderTTHM

string

price

string

GET/v1/dex/holders/trend/list

curl --request GET \
  --url https://pro-api.coinmarketcap.com/v1/dex/holders/trend/list \
  --header 'X-CMC_PRO_API_KEY: YOUR_API_KEY'

shell

Example Responses

[
  {
    "ts": 0,
    "endTs": 0,
    "platform": 0,
    "tokenAddress": "tokenAddress",
    "holders": 0,
    "holdingRatioOfTop100": "holdingRatioOfTop100",
    "holdingRatioOfTop50": "holdingRatioOfTop50",
    "holdingRatioOfTop10": "holdingRatioOfTop10",
    "totalBalanceOfTop100": "totalBalanceOfTop100",
    "totalBalanceOfTop50": "totalBalanceOfTop50",
    "totalBalanceOfTop10": "totalBalanceOfTop10",
    "biggerThan10DHolders": 0,
    "avgBalanceAllHolders": "avgBalanceAllHolders",
    "avgBalanceOfTop100": "avgBalanceOfTop100",
    "avgPositionCostOfTop100": "avgPositionCostOfTop100",
    "avgSellPriceOfTop100": "avgSellPriceOfTop100",
    "tagHolder": "tagHolder",
    "avgBalanceUSDAllHolders": "avgBalanceUSDAllHolders",
    "avgBalanceUSDOfTop100": "avgBalanceUSDOfTop100",
    "tagHolderTTHM": "tagHolderTTHM",
    "price": "price"
  }
]

text

application/octet-stream

Get holder tag count

GET

https://pro-api.coinmarketcap.com

/v1/dex/holders/tag_count

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

object[]

platformId

integer · int32

tokenAddress

string

Get holder count

GET

https://pro-api.coinmarketcap.com

/v1/dex/holders/count

Get detailed information for holders count

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

platformId

integer · int32

count

integer · int64

tokenAddress

string

Platform OHLCV

Get holders list

POST

https://pro-api.coinmarketcap.com

/v1/dex/holders/list

Get detailed information for holders list

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

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

object[]

Get holder detail

POST

https://pro-api.coinmarketcap.com

/v1/dex/holders/detail

Get detailed information for holders detail

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

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

blockHeight

integer · int64

firstActiveTime

integer · int64

netBuyAmount

string

realizedPnlPercent

string

spotPosition

string

buyVolume

string

sellVolume

string

buyUsd

string

sellUsd

string

buyCount

string

sellCount

string

avgBuyPriceUsd

string

avgSellPriceUsd

string

realizedPnl

string

actualBalance

string

price

string

walletAddress

string

tokenAddress

string

platformId

integer · int32

percent

string

balance

string

totalSupply

string

tokenAccount

string

logoUrl

string

name

string

publicName

string

tags

string

addressExplorerUrl

string

symbol

string

nativeBalance

string

fundingSource

string

fundingTime

integer · int64

lastActiveTime

integer · int64

walletCreateTime

integer · int64

spotOpenTs

integer · int64

spotClearanceTs

integer · int64

tokenLogo

string

tokenSymbol

string

platformCryptoId

integer · int32

dexerPlatformName

string

lowLiquidityFlag

integer · int32

memePumpInnerFlag

integer · int32

blackListFlag

integer · int32

stableCoinFlag

integer · int32

riskLevelFlag

integer · int32

Get holder trend list

GET

https://pro-api.coinmarketcap.com

/v1/dex/holders/trend/list

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

object[]

ts

integer · int64

endTs

integer · int64

platform

integer · int32

tokenAddress

string

holders

integer · int64

holdingRatioOfTop100

string

holdingRatioOfTop50

string

holdingRatioOfTop10

string

totalBalanceOfTop100

string

totalBalanceOfTop50

string

totalBalanceOfTop10

string

biggerThan10DHolders

integer · int64

avgBalanceAllHolders

string

avgBalanceOfTop100

string

avgPositionCostOfTop100

string

avgSellPriceOfTop100

string

tagHolder

string

avgBalanceUSDAllHolders

string

avgBalanceUSDOfTop100

string

tagHolderTTHM

string

price

string

Get holder tag count

GET

https://pro-api.coinmarketcap.com

/v1/dex/holders/tag_count

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

object[]

platformId

integer · int32

tokenAddress

string

Get holder count

GET

https://pro-api.coinmarketcap.com

/v1/dex/holders/count

Get detailed information for holders count

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

platformId

integer · int32

count

integer · int64

tokenAddress

string