获取代币热门 KOL 列表#

获取正在讨论特定代币的热门 KOL(关键意见领袖)列表,可按互动量、提及次数或曝光量排序。

请求路径#

GET
https://web3.okx.com/api/v6/dex/market/social/vibe/top-kols

请求参数#

参数名类型是否必填描述
chainIndexstring链 ID,如 1=以太坊、56=BNB Chain、501=Solana。必填。
tokenAddressstring代币合约地址。EVM 链为 0x... 格式;Solana 为 Base58 编码。必填。
sortBystringKOL 排序方式:1=engagement(互动量)、2=mentions(提及次数)、3=impressions(曝光量)。默认 1。
timeFramestring统计周期:1=24h(近 24 小时)、2=72h(近 72 小时)、3=7d(近 7 天)、4=30d(近 30 天)。默认 1。
limitstring返回 KOL 数量,范围 [1, 50],默认 20。上游最大返回 TOP 50,超出时自动截断。

返回参数#

字段类型描述
kolsarray热门 KOL 列表,最多返回 limit 条
> handlestringKOL 的 X/Twitter 用户名(不含 @)
> nicknamestringKOL 的昵称/显示名称
> avatarstringKOL 的头像图片链接
> followersstringKOL 的粉丝数量
> engagementstring统计周期内该 KOL 的总互动量
> mentionsstring统计周期内该 KOL 发布的相关提及次数
> impressionsstring统计周期内该 KOL 帖子的总曝光量
> firstMentionobject该 KOL 在统计周期内首次提及该代币的推文信息。若无首次提及则为 null(需 summary.supportFirstMentioned=true 才有有效数据)。
>> timestring首次提及的时间戳(Unix 毫秒)
>> contentIdstring首次提及推文的 ID
>> tweetUrlstring首次提及推文的完整链接,格式为 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
            }
        ]
    }
}