Hot Tokens#
Returns a list of tokens ranked by token score and social media mentions based on different time ranges. It can be sorted in descending order according to the specified data, and can also be filtered based on the specified data. Up to 100 results are returned.
Request Path#
GET https://web3.okx.com/api/v6/dex/market/token/hot-token
Request Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
| rankingType | String | Yes | Default use trending, does not support multiple selection 4: Trending, sorting by token score 5: Xmentioned, sorting by number of mentions on Twitter Note: Only 4 and 5, no 1, 2, 3. |
| chainIndex | String | No | Default is all networks, it does not support multiple selection chain. Example: 1, Filter out the tokens of the Ethereum chain |
| rankBy | String | No | Trending lists are sorted backwards by "12" by default; The Xmentioned list is sorted by default in reverse order according to "11". Sort in reverse order according to more parameters, single choice Enter 1: token price | Enter 2: price changes percent | Enter 3: transactions | Enter 4: unique traders | Enter 5: volume(in USD) | Enter 6: marketcap | Enter 7: liquidity value | Enter 8: token creation time | Enter 9: OKX in-app search frequency | Enter 10: number of holder | Enter 11: mentions on social media | Enter 12: social media scores | Enter 14: net inflow | Enter 15: token score |
| rankingTimeFrame | String | No | Default is 1h, single choice 1: 5 minutes | 2: 1 hour | 3: 4 hours | 4: 24 hours |
| riskFilter | Boolean | No | Hide risk tokens, default is true. Example: true, false |
| protocolId | String | No | Filter tokens by protocol ID. No protocol is selected by default, multiple options can be selected, separated by commas (For example, 120596 can filter out tokens Pump.fun protocols) |
| priceChangePercentMin | String | No | Minimum price change percent |
| priceChangePercentMax | String | No | Maximum price change percent |
| tradeAmountMin | String | No | Minimum volume |
| tradeAmountMax | String | No | Maximum volume |
| volumeMin | String | No | Minimum turnover |
| volumeMax | String | No | Maximum turnover |
| txsMin | String | No | Minimum number of transactions |
| txsMax | String | No | Maximum number of transactions |
| uniqueTraderMin | String | No | Minimum number of unique trader |
| uniqueTraderMax | String | No | Maximum number of unique trader |
| marketCapMin | String | No | Minimum Marketcap |
| marketCapMax | String | No | Maximum Marketcap |
| liquidityMin | String | No | Minimum liquidity |
| liquidityMax | String | No | Maximum liquidity |
| stableTokenFilter | Boolean | No | Whether to filter stablecoins, the default is true. Example: true, false |
| holdersMin | String | No | Minimum number of holders |
| holdersMax | String | No | Maximum number of holders |
| top10HoldPercentMin | String | No | Top 10 minimum holding percent |
| top10HoldPercentMax | String | No | Top 10 maximum holding percent |
| devHoldPercentMin | String | No | Minimum developer holding percent |
| devHoldPercentMax | String | No | Maximum developer holding percent |
| suspiciousHoldPercentMin | String | No | Minimum suspicious holding percent |
| suspiciousHoldPercentMax | String | No | Maximum suspicious holding percent |
| bundleHoldPercentMin | String | No | Minimum binding holding percent |
| bundleHoldPercentMax | String | No | Maximum binding holding percent |
| mentionedCountMin | String | No | Minimum number of mentions |
| mentionedCountMax | String | No | Maximum number of mentions |
| socialScoreMin | String | No | Minimum social score |
| socialScoreMax | String | No | Maximum social score |
| isLpBurnt | Boolean | No | Whether LP is burned, the default is true. Example: true, false |
| isMint | Boolean | No | Whether it can be mint, the default is true. Example: true, false |
| isFreeze | Boolean | No | Whether to freeze, default is true. Example: true, false |
| inflowUsdMin | String | No | Minimum inflow |
| inflowUsdMax | String | No | Maximum inflow |
| fdvMin | String | No | FDV minimum |
| fdvMax | String | No | Maximum FDV |
Response Parameters#
| Field | Type | Description |
|---|---|---|
| chainIndex | String | Unique identifier of the chain (e.g. 1: Ethereum) |
| tokenSymbol | String | Token symbol |
| tokenLogoUrl | String | Token Icon URL |
| tokenContractAddress | String | Token contract address |
| marketCap | String | Marketcap (token price × circulating supply) |
| volume | String | Token trading volume (in USD) |
| firstTradeTime | String | Token first transaction time |
| change | String | Token price change ratio |
| liquidity | String | Liquidity value (in USD) |
| price | String | Token price |
| holders | String | Number of holder |
| uniqueTraders | String | The number of unique trader |
| txsBuy | String | The number of buy transactions within the specified time |
| txsSell | String | Number of sell transactions within a specified time |
| txs | String | Total number of transactions within a specified time |
| inflowUsd | String | Net inflow |
| riskLevelControl | String | Risk control level: 0=undefined, 1=low, 2=medium, 3=medium high, 4=high, 5=high (manual configuration) |
| devHoldPercent | String | Developer position percent |
| top10HoldPercent | String | Position ratio of top 10 holding addresses |
| insiderHoldPercent | String | Internal trader position percent |
| bundleHoldPercent | String | Bundled trader position percent |
| vibeScore | String | Social media score |
| mentionsCount | String | Number of mentions |
Request Example#
Shell
curl --location 'https://web3pre.okex.org/api/v6/dex/market/token/hot-token?rankingType=4&category=' \
--header 'Cookie: locale=en-US'
Response Example#
Json
{
"code": "0",
"data": [
{
"bundleHoldPercent": "",
"chainIndex": "42161",
"change": "1.23",
"devHoldPercent": "",
"firstTradeTime": "1677821938000",
"holders": "",
"inflowUsd": "27668.75900895417375103",
"insiderHoldPercent": "",
"liquidity": "1154916.100399227159548253",
"marketCap": "8000679.968883597495939944",
"mentionsCount": "",
"price": "109.183774625627123045",
"riskLevelControl": "2",
"tokenContractAddress": "0xba5ddd1f9d7f570dc94a51479a000e3bce967196",
"tokenLogoUrl": "https://static.oklink.com/cdn/web3/currency/token/pre/large/501-3vAs4D1WE6Na4tCgt4BApgFfENbm8WY7q4cSPD1yM4Cg-105/type=webp_90_0?v=1773081497496",
"tokenSymbol": "AAVE",
"top10HoldPercent": "0",
"txs": "252",
"txsBuy": "188",
"txsSell": "64",
"uniqueTraders": "54",
"vibeScore": "",
"volume": "38875.13700276913986497"
}
],
"msg": ""
}