获取代币集群列表#
获取指定代币的持仓集群的列表数据，仅包含持仓 top300 的地址集群。
限制：仅返回持仓数量前 100 个集群
请求路径#
GET https://web3.okx.com/api/v6/dex/market/token/cluster/list
请求参数#
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| chainIndex | string | 是 | 链的唯一标识，传入链的 ID（如 501: Solana），仅支持单链查询 |
| tokenContractAddress | string | 是 | 代币合约地址 |
响应参数#
| 参数 | 类型 | 描述 |
|---|---|---|
| clustList | array | 集群列表 |
| > holdingAmount | string | 集群地址持有的所有代币数量总和（不包括黑洞和流动性池地址） |
| > holdingValueUsd | string | 集群地址持有的所有代币美元价值总和（不包括黑洞和流动性池地址） |
| > holdingPercent | string | 集群地址持有的代币供应量百分比 |
| > trendType | object | 买入/卖出/中性/转移主导，指集群交易者持仓随时间的整体方向——增加（买入）、下降（卖出）、持平（中性）或主要通过转移积累（转移主导） |
| > averageHoldingPeriod | string | 集群持有者的加权平均持有时间 |
| > pnlUsd | string | 集群持有者的代币总盈亏 |
| > pnlPercent | string | 集群持有者的代币总盈亏百分比 |
| > buyVolume | string | 集群持有者买入代币价值 |
| > averageBuyPriceUsd | string | 集群持有者的平均成本价 |
| > sellVolume | string | 集群持有者卖出代币价值 |
| > averageSellPriceUsd | string | 集群持有者的加权平均售价 |
| > lastActiveTimestamp | string | 最近活跃时间 |
| > clusterAddressList | array | 集群持有者地址列表 |
| >> address | string | 地址 |
| >> holdingAmount | string | 集群地址持有的所有代币数量总和（不包括黑洞和流动性池地址） |
| >> holdingValueUsd | string | 集群地址持有的所有代币美元价值总和（不包括黑洞和流动性池地址） |
| >> holdingPercent | string | 集群地址持有的代币供应量百分比 |
| >> averageHoldingPeriod | string | 地址平均持有时间 |
| >> lastActiveTimestamp | string | 最近活跃时间 |
| >> isContract | boolean | 是否是合约地址 |
| >> isExchange | boolean | 是否是交易所地址 |
| >> isKol | boolean | 是否是 KOL 地址 |
| >> addressRank | string | 地址持仓排名 |
请求示例#
Shell
curl --location --request GET 'https://web3.okx.com/api/v6/dex/market/token/cluster/list?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'
响应示例#
Json
{
"code": "0",
"data": [
{
"clustList": [
{
"holdingAmount": "320000000.00",
"holdingValueUsd": "320145600.00",
"holdingPercent": "6.52",
"trendType": {
"trendType": "buy"
},
"averageHoldingPeriod": "62",
"pnlUsd": "45230.12",
"pnlPercent": "14.15",
"buyVolume": "980000.00",
"averageBuyPriceUsd": "0.9982",
"sellVolume": "210000.00",
"averageSellPriceUsd": "1.0015",
"lastActiveTimestamp": "1697630501000",
"clusterAddressList": [
{
"address": "0x28c6c06298d514db089934071355e5743bf21d60",
"holdingAmount": "180000000.00",
"holdingValueUsd": "180082800.00",
"holdingPercent": "3.67",
"averageHoldingPeriod": "75",
"lastActiveTimestamp": "1697630501000",
"isContract": false,
"isExchange": true,
"isKol": false,
"addressRank": "1"
}
]
}
]
}
],
"msg": ""
}