Get Token Holding Cluster Overview#
Get the holding cluster overview data for a specified token.
Request Path#
GET https://web3.okx.com/api/v6/dex/market/token/cluster/overview
Request Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
| chainIndex | String | Yes | Unique chain identifier. Pass in the chain ID (e.g., 501 for Solana). Only supports single-chain queries |
| tokenContractAddress | String | Yes | Token contract address |
Response Parameters#
| Field | Type | Description |
|---|---|---|
| ClusterConcentration | String | Cluster concentration level: Low / Medium / High |
| top100HoldingsPercent | String | Top 100 address holding percentage (%) |
| rugPullPercent | String | Rug pull probability percentage (%) |
| holderNewAddressPercent | String | Percentage of new addresses created within the past 3 days among the top 1000 holders (%) |
| holderSameFundSourcePercent | String | Percentage of addresses among the top 1000 holders that have mutual mainstream token transactions with each other |
| holderSameCreationTimePercent | String | Percentage of addresses created at the same time (%) |
Request Example#
Shell
curl --location --request GET 'https://web3.okx.com/api/v6/dex/market/token/cluster/overview?chainIndex=1&tokenContractAddress=0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48' \
--header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \
--header 'OK-ACCESS-SIGN: leaV********3uw=' \
--header 'OK-ACCESS-PASSPHRASE: 1****6' \
--header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z'
Response Example#
Json
{
"code": "0",
"data": [
{
"ClusterConcentration": "HIGH",
"top100HoldingsPercent": "42.35",
"rugPullPercent": "12.50",
"holderNewAddressPercent": "8.20",
"holderSameFundSourcePercent": "15.60",
"holderSameCreationTimePercent": "6.80"
}
],
"msg": ""
}