获取代币列表#
获取筛选条件下的代币列表,上限 30 条。
请求 URL#
GET https://web3.okx.com/api/v6/dex/market/memepump/tokenList
请求参数#
| 参数名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| chainIndex | String | 是 | 链唯一标识。如 501 = Solana,56 = BSC。仅支持单链查询。 |
| stage | String | 是 | 代币生命周期阶段筛选。枚举值:NEW = 新创建代币,MIGRATING = 即将迁移至 DEX 的代币,MIGRATED = 已完成迁移至 DEX 的代币。 |
| walletAddress | String | 否 | 用户钱包地址。传入后,响应将包含用户专属持仓数据(如持仓量、盈亏)。 |
| protocolIdList | String | 否 | 逗号分隔的协议 ID 列表,用于筛选指定协议。如 "120596" 表示 PumpFun,"120596,139661" 表示多个协议。可通过 /memepump/supported/chainsProtocol 获取可用协议 ID。 |
| quoteTokenAddressList | String | 否 | 逗号分隔的计价代币合约地址列表。如 "So11111111111111111111111111111111111111111" 表示 SOL。按交易对的计价货币筛选代币。 |
| minTop10HoldingsPercent | String | 否 | 前 10 大持有者占总供应量的最小百分比。取值范围:0–100。如 "10" 表示前 10 大持有者至少持有 10%。 |
| maxTop10HoldingsPercent | String | 否 | 前 10 大持有者占总供应量的最大百分比。取值范围:0–100。 |
| minDevHoldingsPercent | String | 否 | 开发者钱包持有总供应量的最小百分比。取值范围:0–100。 |
| maxDevHoldingsPercent | String | 否 | 开发者钱包持有总供应量的最大百分比。取值范围:0–100。 |
| minInsidersPercent | String | 否 | 内部钱包占所有持有者的最小百分比。取值范围:0–100。 |
| maxInsidersPercent | String | 否 | 内部钱包占所有持有者的最大百分比。取值范围:0–100。 |
| minBundlersPercent | String | 否 | 捆绑交易钱包占所有持有者的最小百分比。取值范围:0–100。捆绑者是将多笔交易打包执行的钱包。 |
| maxBundlersPercent | String | 否 | 捆绑交易钱包占所有持有者的最大百分比。取值范围:0–100。 |
| minSnipersPercent | String | 否 | 狙击钱包占所有持有者的最小百分比。取值范围:0–100。狙击者是在代币上线后极早买入的钱包。 |
| maxSnipersPercent | String | 否 | 狙击钱包占所有持有者的最大百分比。取值范围:0–100。 |
| minFreshWalletsPercent | String | 否 | 新创建钱包占所有持有者的最小百分比。取值范围:0–100。 |
| maxFreshWalletsPercent | String | 否 | 新创建钱包占所有持有者的最大百分比。取值范围:0–100。 |
| minSuspectedPhishingWalletPercent | String | 否 | 疑似钓鱼钱包占所有持有者的最小百分比。取值范围:0–100。 |
| maxSuspectedPhishingWalletPercent | String | 否 | 疑似钓鱼钱包占所有持有者的最大百分比。取值范围:0–100。 |
| minBotTraders | String | 否 | 机器人交易钱包数量最小值。 |
| maxBotTraders | String | 否 | 机器人交易钱包数量最大值。 |
| minDevMigrated | String | 否 | 同一开发者此前完成迁移的代币数量最小值。可用于评估开发者历史记录。 |
| maxDevMigrated | String | 否 | 同一开发者此前完成迁移的代币数量最大值。 |
| communityTakeover | Boolean | 否 | 按是否发生社区接管(CTO)筛选。true = 仅返回 CTO 代币,false = 仅返回非 CTO 代币。 |
| minFeesNative | String | 否 | 该代币消耗的链原生代币手续费最小值(如 SOL)。 |
| maxFeesNative | String | 否 | 该代币消耗的链原生代币手续费最大值。 |
| minTxCount | String | 否 | 代币总交易笔数最小值。 |
| maxTxCount | String | 否 | 代币总交易笔数最大值。 |
| minBondingPercent | String | 否 | 联合曲线完成度最小百分比。取值范围:0–100。适用于 stage=NEW 或 stage=MIGRATING。 |
| maxBondingPercent | String | 否 | 联合曲线完成度最大百分比。取值范围:0–100。 |
| minMarketCapUsd | String | 否 | 最小市值(USD)。如 "50000" 表示市值 ≥ $50,000。 |
| maxMarketCapUsd | String | 否 | 最大市值(USD)。 |
| minVolumeUsd | String | 否 | 最小 24 小时交易量(USD)。 |
| maxVolumeUsd | String | 否 | 最大 24 小时交易量(USD)。 |
| minHolders | String | 否 | 最小唯一持有者数量。如 "100" 表示至少 100 个持有者。 |
| maxHolders | String | 否 | 最大唯一持有者数量。 |
| minTokenAge | String | 否 | 代币最小年龄(分钟)。stage=MIGRATED 时从迁移时间戳起算,否则从创建时间戳起算。如 "60" 表示至少 1 小时。 |
| maxTokenAge | String | 否 | 代币最大年龄(分钟)。stage=MIGRATED 时从迁移时间戳起算,否则从创建时间戳起算。 |
| minBuyTxCount | String | 否 | 最近 1 小时内买入交易笔数最小值。 |
| maxBuyTxCount | String | 否 | 最近 1 小时内买入交易笔数最大值。 |
| minSellTxCount | String | 否 | 最近 1 小时内卖出交易笔数最小值。 |
| maxSellTxCount | String | 否 | 最近 1 小时内卖出交易笔数最大值。 |
| minTokenSymbolLength | String | 否 | 代币代码最小长度。如 "3" 表示代码至少 3 个字符。 |
| maxTokenSymbolLength | String | 否 | 代币代码最大长度。 |
| hasAtLeastOneSocialLink | Boolean | 否 | 按是否拥有至少一个社交媒体链接筛选。true = 必须有至少一个社交链接。 |
| hasX | Boolean | 否 | 按是否拥有 X(Twitter)链接筛选。true = 必须有 X 链接。 |
| hasTelegram | Boolean | 否 | 按是否拥有 Telegram 链接筛选。true = 必须有 Telegram 链接。 |
| hasWebsite | Boolean | 否 | 按是否拥有官方网站链接筛选。true = 必须有网站。 |
| websiteTypeList | String | 否 | 逗号分隔的网站类型代码。枚举值:0 = 官网(其他),1 = YouTube,2 = Twitch,3 = Facebook,4 = Instagram,5 = TikTok,6 = Discord,7 = GitHub。如 "1,6" 表示有 YouTube 或 Discord 链接的代币。 |
| dexScreenerPaid | Boolean | 否 | 按是否已在 DexScreener 付费推广筛选。true = 仅返回已付费推广的代币。 |
| liveOnPumpFun | Boolean | 否 | 按是否正在 PumpFun 直播筛选。true = 仅返回有活跃 PumpFun 直播的代币。 |
| bagsFeeClaimed | Boolean | 否 | 按开发者是否已领取 Bags 费用(版税)筛选。true = 开发者已领取费用。 |
| devSellAll | Boolean | 否 | 按开发者是否已清仓筛选。true = 开发者已全部卖出。 |
| devStillHolding | Boolean | 否 | 按开发者是否仍持有代币筛选。true = 开发者仍持有代币。 |
| keywordsInclude | String | 否 | 筛选名称或代码中包含指定关键词的代币,不区分大小写。如 "dog" 可匹配 "DOGE"、"DogWifHat"。 |
| keywordsExclude | String | 否 | 排除名称或代码中包含指定关键词的代币,不区分大小写。 |
返回参数#
| 参数名 | 类型 | 描述 |
|---|---|---|
| cursor | String | 下一页分页游标,无更多数据时为空。 |
| items | Array | 代币列表。 |
| >chainIndex | String | 链 ID(如 501 = Solana)。 |
| >protocolId | String | 协议来源编号(如 1 = PUMP_FUN)。 |
| >quoteTokenAddress | String | 计价代币合约地址。 |
| >tokenContractAddress | String | Token 合约地址。 |
| >symbol | String | Token 符号。 |
| >name | String | Token 名称。 |
| >logoUrl | String | Token 图标 URL。 |
| >createdTimestamp | String | Token 创建时间(毫秒时间戳)。 |
| >market | Object | 市场数据。 |
| >>marketCapUsd | String | 市值(USD)。 |
| >>volumeUsd1h | String | 1 小时成交额(USD)。 |
| >>txCount1h | String | 1 小时总交易数。 |
| >>buyTxCount1h | String | 1 小时买入交易数。 |
| >>sellTxCount1h | String | 1 小时卖出交易数。 |
| >bondingPercent | String | 进度数据(%)。 |
| >mayhemModeTimeRemaining | String | Pump.fun 的 Mayhem Mode 剩余时间,非此模式代币则返回空。 |
| >tags | Object | 标签 / 审计类数据。 |
| >>top10HoldingsPercent | String | Top10 持仓占比(%)。 |
| >>devHoldingsPercent | String | Dev 持仓占比(%)。 |
| >>insidersPercent | String | Insiders 占比(%)。 |
| >>bundlersPercent | String | Bundlers 占比(%)。 |
| >>snipersPercent | String | Snipers 占比(%)。 |
| >>freshWalletsPercent | String | Fresh wallets 占比(%)。 |
| >>suspectedPhishingWalletPercent | String | 疑似钓鱼钱包(%)。 |
| >>totalHolders | String | 持币地址数量。 |
| >social | Object | 社交媒体信息。 |
| >>x | String | X(Twitter)链接。 |
| >>telegram | String | Telegram 链接。 |
| >>website | String | 网站链接。 |
| >>websiteType | String | 官网类型。 |
| >>dexScreenerPaid | Boolean | DEX Screener paid。 |
| >>communityTakeover | Boolean | CTO(社区接管)。 |
| >>liveOnPumpFun | Boolean | Live on Pump.fun。 |
| >bagsFeeClaimed | Boolean | 是否 claim bag fee。 |
| >aped | String | 同车钱包数量。 |
| >migratedBeginTimestamp | String | 迁移开始时间(ISO 8601)。 |
| >migratedEndTimestamp | String | 迁移结束时间(ISO 8601)。 |
| >creatorAddress | String | 代币创建者钱包地址。 |
请求示例#
Shell
curl --location --request GET 'https://web3.okx.com/api/v6/dex/market/memepump/tokenList?chainIndex=501&protocolId=1&sort=createdTimestamp&order=desc&limit=30' \
--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": {
"cursor": "eyJsYXN0SWQiOiI3R2Y5Li4ucHVtcCJ9",
"items": [
{
"chainIndex": "501",
"protocolId": "1",
"quoteTokenAddress": "1111...1111",
"tokenContractAddress": "7Gf9...pump",
"symbol": "TETANUS",
"name": "tetanus",
"logoUrl": "https://static.okx.com/cdn/assets/imgs/xxx.png",
"createdTimestamp": "1730000000000",
"market": {
"marketCapUsd": "154880.12",
"volumeUsd1h": "50231.11",
"txCount1h": "225",
"buyTxCount1h": "128",
"sellTxCount1h": "97"
},
"bondingPercent": "63.5",
"mayhemModeTimeRemaining": "",
"tags": {
"top10HoldingsPercent": "0.12",
"devHoldingsPercent": "0.10",
"insidersPercent": "0.23",
"bundlersPercent": "0.48",
"snipersPercent": "0.35",
"freshWalletsPercent": "0.50",
"suspectedPhishingWalletPercent": "0.00",
"totalHolders": "2080"
},
"social": {
"x": "https://x.com/xxxx",
"telegram": "https://t.me/xxxx",
"website": "https://xxxx.com",
"websiteType": "1",
"dexScreenerPaid": false,
"communityTakeover": false,
"liveOnPumpFun": true
},
"bagsFeeClaimed": false,
"aped": "12",
"migratedBeginTimestamp": "2025-06-01T08:00:00Z",
"migratedEndTimestamp": "2025-06-01T08:20:00Z",
"creatorAddress": "3kXoZt...q1Re"
},
{
"chainIndex": "56",
"protocolId": "3",
"quoteTokenAddress": "0x55d398326f99059fF775485246999027B3197955",
"tokenContractAddress": "0x12ab...cdef",
"symbol": "SUNNY",
"name": "Sunny Meme",
"logoUrl": "https://static.okx.com/cdn/assets/imgs/yyy.png",
"createdTimestamp": "1730000300000",
"market": {
"marketCapUsd": "92100.50",
"volumeUsd1h": "118900.00",
"txCount1h": "512",
"buyTxCount1h": "410",
"sellTxCount1h": "102"
},
"bondingPercent": "20.50",
"mayhemModeTimeRemaining": "",
"tags": {
"top10HoldingsPercent": "22.10",
"devHoldingsPercent": "4.50",
"suspectedPhishingWalletPercent": "0.00",
"totalHolders": "420"
},
"social": {
"x": "",
"telegram": "https://t.me/sunny_meme",
"website": "",
"websiteType": "",
"dexScreenerPaid": false,
"communityTakeover": false,
"liveOnPumpFun": false
},
"bagsFeeClaimed": false,
"aped": "12",
"migratedBeginTimestamp": "2025-06-01T08:00:00Z",
"migratedEndTimestamp": "2025-06-01T08:20:00Z",
"creatorAddress": "0xXoZt...q1Re"
}
]
}
}