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=8453&tokenContractAddress=0xfde4c96c8593536e31f229ea8f37b2ada2699bb2' \
--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,
"msg": "success",
"error_code": "0",
"error_message": "",
"detailMsg": "",
"data": {
"clusterConcentration": "Low",
"top100HoldingsPercent": "0.68776",
"rugPullPercent": "1.00000",
"holderNewAddressPercent": "--",
"holderSameFundSourcePercent": "0.47800",
"holderSameCreationTimePercent": "0.09000"
}
}