Get Top KOLs for Token#
Retrieve the top Key Opinion Leaders (KOLs) discussing a specific token, sorted by engagement, mentions, or impressions.
Request Path#
GET
https://web3.okx.com/api/v6/dex/market/social/vibe/top-kolsRequest Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
| chainIndex | string | Yes | Chain ID, e.g. 1=Ethereum, 56=BNB Chain, 501=Solana. |
| tokenAddress | string | Yes | Token contract address. EVM chains use 0x... format; Solana uses Base58 encoding. |
| sortBy | string | No | KOL sort order: 1=engagement, 2=mentions, 3=impressions. Default 1. |
| timeFrame | string | No | Statistical period: 1=24h (last 24 hours), 2=72h (last 72 hours), 3=7d (last 7 days), 4=30d (last 30 days). Default 1. |
| limit | string | No | Number of KOLs to return, range [1, 50], default 20. Upstream maximum is TOP 50; results will be truncated if exceeded. |
Response Parameters#
| Field | Type | Description |
|---|---|---|
| kols | array | Top KOL list, up to limit records |
| > handle | string | KOL's X/Twitter username (without @) |
| > nickname | string | KOL's display name |
| > avatar | string | KOL's avatar image URL |
| > followers | string | KOL's follower count |
| > engagement | string | Total engagement by this KOL within the statistical period |
| > mentions | string | Number of relevant posts by this KOL within the statistical period |
| > impressions | string | Total impressions of this KOL's posts within the statistical period |
| > firstMention | object | Information about the KOL's first mention of the token in the statistical period. Null if not available (requires summary.supportFirstMentioned=true to be valid). |
| >> time | string | Timestamp of the first mention (Unix milliseconds) |
| >> contentId | string | Tweet ID of the first mention |
| >> tweetUrl | string | Full URL of the first mention tweet, format: https://x.com/{handle}/status/{contentId} |
Request Example#
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'
Response Example#
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
}
]
}
}