获取代币指定持仓范围集中度概况#
获取指定代币的持仓地址排名前 10/50/100 的概览数据。
请求路径#
GET https://web3.okx.com/api/v6/dex/market/token/cluster/top-holders
请求参数#
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| chainIndex | string | 是 | 链的唯一标识，传入链的 ID（如 501: Solana），仅支持单链查询 |
| tokenContractAddress | string | 是 | 代币合约地址 |
| rangeFilter | string | 是 | 持仓排名前 10/50/100 地址数据，值值：1=10，2=50，3=100 |
响应参数#
| 参数 | 类型 | 描述 |
|---|---|---|
| holdingAmount | string | 前 10/50/100 个地址持有的所有代币数量总和（不包括黑洞和流动性池地址） |
| holdingPercent | string | 前 10/50/100 个地址持有的代币供应量百分比 |
| clusterTrendType | object | 买入/卖出/中性/转移主导，指交易者持仓随时间的整体方向——增加（买入）、下降（卖出）、持平（中性）或主要通过转移积累（转移主导） |
| averageHoldingPeriod | string | 前 10/50/100 位持有者的加权平均持有时间 |
| averagePnlUsd | string | 前 10/50/100 名持有者的加权平均盈亏 |
| averageBuyPriceUsd | string | 前 10/50/100 名持有者的加权平均成本价 |
| averageBuyPricePercent | string | 前 10/50/100 名持有者的平均成本价与当前代币价格之间的百分比差异 |
| averageSellPriceUsd | string | 前 10/50/100 名持有者的加权平均售价 |
| averageSellPricePercent | string | 前 10/50/100 位持有者的平均售价与当前代币价格之间的百分比差异 |
请求示例#
Shell
curl --location --request GET 'https://web3.okx.com/api/v6/dex/market/token/cluster/top-holders?chainIndex=8453&tokenContractAddress=0xfde4c96c8593536e31f229ea8f37b2ada2699bb2&rangeFilter=1' \
--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,
"msg": "success",
"error_code": "0",
"error_message": "",
"detailMsg": "",
"data": {
"holdingAmount": "9651442.5",
"holdingPercent": "0.42483",
"clusterTrendType": [
"buy",
"transferIn"
],
"averageHoldingPeriod": "1744614666",
"averagePnlUsd": "null",
"averageBuyPriceUsd": "null",
"averageBuyPricePercent": "null",
"averageSellPriceUsd": "null",
"averageSellPricePercent": "null"
}
}