获取代币热门 KOL 列表#
获取正在讨论特定代币的热门 KOL(关键意见领袖)列表,可按互动量、提及次数或曝光量排序。
请求路径#
GET
https://web3.okx.com/api/v6/dex/market/social/vibe/top-kols请求参数#
| 参数名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| chainIndex | string | 是 | 链 ID,如 1=以太坊、56=BNB Chain、501=Solana。必填。 |
| tokenAddress | string | 是 | 代币合约地址。EVM 链为 0x... 格式;Solana 为 Base58 编码。必填。 |
| sortBy | string | 否 | KOL 排序方式:1=engagement(互动量)、2=mentions(提及次数)、3=impressions(曝光量)。默认 1。 |
| timeFrame | string | 否 | 统计周期:1=24h(近 24 小时)、2=72h(近 72 小时)、3=7d(近 7 天)、4=30d(近 30 天)。默认 1。 |
| limit | string | 否 | 返回 KOL 数量,范围 [1, 50],默认 20。上游最大返回 TOP 50,超出时自动截断。 |
返回参数#
| 字段 | 类型 | 描述 |
|---|---|---|
| kols | array | 热门 KOL 列表,最多返回 limit 条 |
| > handle | string | KOL 的 X/Twitter 用户名(不含 @) |
| > nickname | string | KOL 的昵称/显示名称 |
| > avatar | string | KOL 的头像图片链接 |
| > followers | string | KOL 的粉丝数量 |
| > engagement | string | 统计周期内该 KOL 的总互动量 |
| > mentions | string | 统计周期内该 KOL 发布的相关提及次数 |
| > impressions | string | 统计周期内该 KOL 帖子的总曝光量 |
| > firstMention | object | 该 KOL 在统计周期内首次提及该代币的推文信息。若无首次提及则为 null(需 summary.supportFirstMentioned=true 才有有效数据)。 |
| >> time | string | 首次提及的时间戳(Unix 毫秒) |
| >> contentId | string | 首次提及推文的 ID |
| >> tweetUrl | string | 首次提及推文的完整链接,格式为 https://x.com/{handle}/status/{contentId} |
请求示例#
shell
curl --location --request GET 'https://web3.okx.com/api/v6/dex/market/social/vibe/top-kols?chainIndex=1&tokenAddress=0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2&sortBy=1&timeFrame=1&limit=20' \
--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": "",
"data": {
"kols": [
{
"handle": "VitalikButerin",
"nickname": "vitalik.eth",
"avatar": "https://pbs.twimg.com/profile_images/977496875887558661/L86xyLF4_400x400.jpg",
"followers": "5200000",
"engagement": "125400",
"mentions": "8",
"impressions": "4800000",
"firstMention": {
"time": "1697544101000",
"contentId": "1714567890123456789",
"tweetUrl": "https://x.com/VitalikButerin/status/1714567890123456789"
}
},
{
"handle": "sassal0x",
"nickname": "sassal.eth",
"avatar": "https://pbs.twimg.com/profile_images/example_400x400.jpg",
"followers": "180000",
"engagement": "45200",
"mentions": "12",
"impressions": "980000",
"firstMention": {
"time": "1697547701000",
"contentId": "1714578901234567890",
"tweetUrl": "https://x.com/sassal0x/status/1714578901234567890"
}
},
{
"handle": "AnthonyPompliano",
"nickname": "Pomp",
"avatar": "https://pbs.twimg.com/profile_images/pomp_400x400.jpg",
"followers": "1680000",
"engagement": "38900",
"mentions": "5",
"impressions": "2100000",
"firstMention": null
}
]
}
}