CoinMarketCapCoinMarketCap
PricingAPI StatusGet an API Key

© 2026 CoinMarketCap. All rights reserved.

xgithub
  • Guides
  • Pro API References
  • AI Tools
  • Changelog
  • FAQ
Endpoint Overview
Pro API
    Cryptocurrency
    Exchange
    Global Metrics
    Content
    Community
    CMC Index
Dex API
    Token
    Platform
    Holder
      Get holders listpostGet holder detailpostGet holder trend listgetGet holder tag countgetGet holder countget
    OHLCV
    Others
Tools
    CoinMarketCap ID MapgetKey InfogetPostman Conversion v1getPrice Conversion v2get
Deprecated
    Metadata v1 (deprecated)getPrice Conversion v1 (deprecated)getMarket Pairs Latest v1 (deprecated)getOHLCV Historical v1 (deprecated)getOHLCV Latest v1 (deprecated)getPrice Performance Stats v1 (deprecated)getQuotes Historical v1 (deprecated)getQuotes Latest v1 (deprecated)getFCAS Listings Latest (deprecated)getFCAS Quotes Latest (deprecated)get
CoinMarketCap Cryptocurrency API Documentation
CoinMarketCap Cryptocurrency API Documentation

Holder

Endpointhttps://pro-api.coinmarketcap.com

Token holder analytics and distribution data.


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
internalUse
​integer · int32
historicalAccess
​string
historicalAccessDaily
​string
convertRestriction
​integer · int32
visibleFieldConfig
​string[] · unique
unlimitedTokenKey
​boolean
​object
tokenAddress
​string

Token contract address

Example: 0x1234567890abcdef1234567890abcdef12345678
platform
​string

Blockchain platform

Example: ethereum
tag
​string

Tag or label

Example: whale

Get holders list › Responses

200

OK

No data returned
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 ' { "internalUse": 0, "historicalAccess": "historicalAccess", "historicalAccessDaily": "historicalAccessDaily", "convertRestriction": 0, "visibleFieldConfig": [ "string" ], "unlimitedTokenKey": true, "accountPlan": { "accountId": "accountId", "productNo": "productNo", "planId": "planId", "enable": true, "paymentRequired": true, "paymentComplete": true, "validStartDate": "2024-08-25T15:00:00Z", "validEndDate": "2024-08-25T15:00:00Z", "rateLimitMinute": 0, "monthlyQuota": 0, "planDefaultMonthlyQuota": 0, "accessEndpointSet": [ 0 ], "internalUse": 0, "convertRestriction": 0, "limitMonthlyHard": 0, "websocketsAccess": true, "overageBilling": true, "historicalAccess": 0, "historicalAccessDaily": 0, "dexHistoricalAccess": 0, "paymentExpireTimestamp": "2024-08-25T15:00:00Z", "usageAnchorTimestamp": "2024-08-25T15:00:00Z", "createTime": 0, "totalMonthUsage": 0, "minuteReqTimes": 0 }, "tokenAddress": "0x1234567890abcdef1234567890abcdef12345678", "platform": "ethereum", "tag": "whale" } '
shell
Example Request Body
{ "internalUse": 0, "historicalAccess": "historicalAccess", "historicalAccessDaily": "historicalAccessDaily", "convertRestriction": 0, "visibleFieldConfig": [ "string" ], "unlimitedTokenKey": true, "accountPlan": { "accountId": "accountId", "productNo": "productNo", "planId": "planId", "enable": true, "paymentRequired": true, "paymentComplete": true, "validStartDate": "2024-08-25T15:00:00Z", "validEndDate": "2024-08-25T15:00:00Z", "rateLimitMinute": 0, "monthlyQuota": 0, "planDefaultMonthlyQuota": 0, "accessEndpointSet": [ 0 ], "internalUse": 0, "convertRestriction": 0, "limitMonthlyHard": 0, "websocketsAccess": true, "overageBilling": true, "historicalAccess": 0, "historicalAccessDaily": 0, "dexHistoricalAccess": 0, "paymentExpireTimestamp": "2024-08-25T15:00:00Z", "usageAnchorTimestamp": "2024-08-25T15:00:00Z", "createTime": 0, "totalMonthUsage": 0, "minuteReqTimes": 0 }, "tokenAddress": "0x1234567890abcdef1234567890abcdef12345678", "platform": "ethereum", "tag": "whale" }
json
Example Responses
No example specified for this content type
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
internalUse
​integer · int32
historicalAccess
​string
historicalAccessDaily
​string
convertRestriction
​integer · int32
visibleFieldConfig
​string[] · unique
unlimitedTokenKey
​boolean
​object
tokenAddress
​string

Token contract address

Example: 0x1234567890abcdef1234567890abcdef12345678
walletAddress
​string

Wallet address

Example: 0xabcdef1234567890abcdef1234567890abcdef12
platform
​string

Blockchain platform

Example: ethereum
tag
​string

Tag or label

Example: whale

Get holder detail › Responses

200

OK

No data returned
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 ' { "internalUse": 0, "historicalAccess": "historicalAccess", "historicalAccessDaily": "historicalAccessDaily", "convertRestriction": 0, "visibleFieldConfig": [ "string" ], "unlimitedTokenKey": true, "accountPlan": { "accountId": "accountId", "productNo": "productNo", "planId": "planId", "enable": true, "paymentRequired": true, "paymentComplete": true, "validStartDate": "2024-08-25T15:00:00Z", "validEndDate": "2024-08-25T15:00:00Z", "rateLimitMinute": 0, "monthlyQuota": 0, "planDefaultMonthlyQuota": 0, "accessEndpointSet": [ 0 ], "internalUse": 0, "convertRestriction": 0, "limitMonthlyHard": 0, "websocketsAccess": true, "overageBilling": true, "historicalAccess": 0, "historicalAccessDaily": 0, "dexHistoricalAccess": 0, "paymentExpireTimestamp": "2024-08-25T15:00:00Z", "usageAnchorTimestamp": "2024-08-25T15:00:00Z", "createTime": 0, "totalMonthUsage": 0, "minuteReqTimes": 0 }, "tokenAddress": "0x1234567890abcdef1234567890abcdef12345678", "walletAddress": "0xabcdef1234567890abcdef1234567890abcdef12", "platform": "ethereum", "tag": "whale" } '
shell
Example Request Body
{ "internalUse": 0, "historicalAccess": "historicalAccess", "historicalAccessDaily": "historicalAccessDaily", "convertRestriction": 0, "visibleFieldConfig": [ "string" ], "unlimitedTokenKey": true, "accountPlan": { "accountId": "accountId", "productNo": "productNo", "planId": "planId", "enable": true, "paymentRequired": true, "paymentComplete": true, "validStartDate": "2024-08-25T15:00:00Z", "validEndDate": "2024-08-25T15:00:00Z", "rateLimitMinute": 0, "monthlyQuota": 0, "planDefaultMonthlyQuota": 0, "accessEndpointSet": [ 0 ], "internalUse": 0, "convertRestriction": 0, "limitMonthlyHard": 0, "websocketsAccess": true, "overageBilling": true, "historicalAccess": 0, "historicalAccessDaily": 0, "dexHistoricalAccess": 0, "paymentExpireTimestamp": "2024-08-25T15:00:00Z", "usageAnchorTimestamp": "2024-08-25T15:00:00Z", "createTime": 0, "totalMonthUsage": 0, "minuteReqTimes": 0 }, "tokenAddress": "0x1234567890abcdef1234567890abcdef12345678", "walletAddress": "0xabcdef1234567890abcdef1234567890abcdef12", "platform": "ethereum", "tag": "whale" }
json
Example Responses
No example specified for this content type
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

OK

No data returned
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
No example specified for this content type
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

OK

No data returned
GET/v1/dex/holders/tag_count
curl --request GET \ --url 'https://pro-api.coinmarketcap.com/v1/dex/holders/tag_count?platform=%3Cstring%3E&tokenAddress=%3Cstring%3E' \ --header 'X-CMC_PRO_API_KEY: YOUR_API_KEY'
shell
Example Responses
No example specified for this content type
application/octet-stream

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

OK

No data returned
GET/v1/dex/holders/count
curl --request GET \ --url 'https://pro-api.coinmarketcap.com/v1/dex/holders/count?platform=%3Cstring%3E&tokenAddress=%3Cstring%3E' \ --header 'X-CMC_PRO_API_KEY: YOUR_API_KEY'
shell
Example Responses
No example specified for this content type
application/octet-stream

PlatformOHLCV