策略 API

获取代币列表#

获取筛选条件下的代币列表,上限 30 条。

请求 URL#

GET https://web3.okx.com/api/v6/dex/market/memepump/tokenList

请求参数#

参数名类型是否必填描述
chainIndexString链唯一标识。如 501 = Solana,56 = BSC。仅支持单链查询。
stageString代币生命周期阶段筛选。枚举值:NEW = 新创建代币,MIGRATING = 即将迁移至 DEX 的代币,MIGRATED = 已完成迁移至 DEX 的代币。
walletAddressString用户钱包地址。传入后,响应将包含用户专属持仓数据(如持仓量、盈亏)。
protocolIdListString逗号分隔的协议 ID 列表,用于筛选指定协议。如 "120596" 表示 PumpFun,"120596,139661" 表示多个协议。可通过 /memepump/supported/chainsProtocol 获取可用协议 ID。
quoteTokenAddressListString逗号分隔的计价代币合约地址列表。如 "So11111111111111111111111111111111111111111" 表示 SOL。按交易对的计价货币筛选代币。
minTop10HoldingsPercentString前 10 大持有者占总供应量的最小百分比。取值范围:0–100。如 "10" 表示前 10 大持有者至少持有 10%。
maxTop10HoldingsPercentString前 10 大持有者占总供应量的最大百分比。取值范围:0–100。
minDevHoldingsPercentString开发者钱包持有总供应量的最小百分比。取值范围:0–100。
maxDevHoldingsPercentString开发者钱包持有总供应量的最大百分比。取值范围:0–100。
minInsidersPercentString内部钱包占所有持有者的最小百分比。取值范围:0–100。
maxInsidersPercentString内部钱包占所有持有者的最大百分比。取值范围:0–100。
minBundlersPercentString捆绑交易钱包占所有持有者的最小百分比。取值范围:0–100。捆绑者是将多笔交易打包执行的钱包。
maxBundlersPercentString捆绑交易钱包占所有持有者的最大百分比。取值范围:0–100。
minSnipersPercentString狙击钱包占所有持有者的最小百分比。取值范围:0–100。狙击者是在代币上线后极早买入的钱包。
maxSnipersPercentString狙击钱包占所有持有者的最大百分比。取值范围:0–100。
minFreshWalletsPercentString新创建钱包占所有持有者的最小百分比。取值范围:0–100。
maxFreshWalletsPercentString新创建钱包占所有持有者的最大百分比。取值范围:0–100。
minSuspectedPhishingWalletPercentString疑似钓鱼钱包占所有持有者的最小百分比。取值范围:0–100。
maxSuspectedPhishingWalletPercentString疑似钓鱼钱包占所有持有者的最大百分比。取值范围:0–100。
minBotTradersString机器人交易钱包数量最小值。
maxBotTradersString机器人交易钱包数量最大值。
minDevMigratedString同一开发者此前完成迁移的代币数量最小值。可用于评估开发者历史记录。
maxDevMigratedString同一开发者此前完成迁移的代币数量最大值。
communityTakeoverBoolean按是否发生社区接管(CTO)筛选。true = 仅返回 CTO 代币,false = 仅返回非 CTO 代币。
minFeesNativeString该代币消耗的链原生代币手续费最小值(如 SOL)。
maxFeesNativeString该代币消耗的链原生代币手续费最大值。
minTxCountString代币总交易笔数最小值。
maxTxCountString代币总交易笔数最大值。
minBondingPercentString联合曲线完成度最小百分比。取值范围:0–100。适用于 stage=NEWstage=MIGRATING
maxBondingPercentString联合曲线完成度最大百分比。取值范围:0–100。
minMarketCapUsdString最小市值(USD)。如 "50000" 表示市值 ≥ $50,000。
maxMarketCapUsdString最大市值(USD)。
minVolumeUsdString最小 24 小时交易量(USD)。
maxVolumeUsdString最大 24 小时交易量(USD)。
minHoldersString最小唯一持有者数量。如 "100" 表示至少 100 个持有者。
maxHoldersString最大唯一持有者数量。
minTokenAgeString代币最小年龄(分钟)。stage=MIGRATED 时从迁移时间戳起算,否则从创建时间戳起算。如 "60" 表示至少 1 小时。
maxTokenAgeString代币最大年龄(分钟)。stage=MIGRATED 时从迁移时间戳起算,否则从创建时间戳起算。
minBuyTxCountString最近 1 小时内买入交易笔数最小值。
maxBuyTxCountString最近 1 小时内买入交易笔数最大值。
minSellTxCountString最近 1 小时内卖出交易笔数最小值。
maxSellTxCountString最近 1 小时内卖出交易笔数最大值。
minTokenSymbolLengthString代币代码最小长度。如 "3" 表示代码至少 3 个字符。
maxTokenSymbolLengthString代币代码最大长度。
hasAtLeastOneSocialLinkBoolean按是否拥有至少一个社交媒体链接筛选。true = 必须有至少一个社交链接。
hasXBoolean按是否拥有 X(Twitter)链接筛选。true = 必须有 X 链接。
hasTelegramBoolean按是否拥有 Telegram 链接筛选。true = 必须有 Telegram 链接。
hasWebsiteBoolean按是否拥有官方网站链接筛选。true = 必须有网站。
websiteTypeListString逗号分隔的网站类型代码。枚举值:0 = 官网(其他),1 = YouTube,2 = Twitch,3 = Facebook,4 = Instagram,5 = TikTok,6 = Discord,7 = GitHub。如 "1,6" 表示有 YouTube 或 Discord 链接的代币。
dexScreenerPaidBoolean按是否已在 DexScreener 付费推广筛选。true = 仅返回已付费推广的代币。
liveOnPumpFunBoolean按是否正在 PumpFun 直播筛选。true = 仅返回有活跃 PumpFun 直播的代币。
bagsFeeClaimedBoolean按开发者是否已领取 Bags 费用(版税)筛选。true = 开发者已领取费用。
devSellAllBoolean按开发者是否已清仓筛选。true = 开发者已全部卖出。
devStillHoldingBoolean按开发者是否仍持有代币筛选。true = 开发者仍持有代币。
keywordsIncludeString筛选名称或代码中包含指定关键词的代币,不区分大小写。如 "dog" 可匹配 "DOGE""DogWifHat"
keywordsExcludeString排除名称或代码中包含指定关键词的代币,不区分大小写。

返回参数#

参数名类型描述
cursorString下一页分页游标,无更多数据时为空。
itemsArray代币列表。
>chainIndexString链 ID(如 501 = Solana)。
>protocolIdString协议来源编号(如 1 = PUMP_FUN)。
>quoteTokenAddressString计价代币合约地址。
>tokenContractAddressStringToken 合约地址。
>symbolStringToken 符号。
>nameStringToken 名称。
>logoUrlStringToken 图标 URL。
>createdTimestampStringToken 创建时间(毫秒时间戳)。
>marketObject市场数据。
>>marketCapUsdString市值(USD)。
>>volumeUsd1hString1 小时成交额(USD)。
>>txCount1hString1 小时总交易数。
>>buyTxCount1hString1 小时买入交易数。
>>sellTxCount1hString1 小时卖出交易数。
>bondingPercentString进度数据(%)。
>mayhemModeTimeRemainingStringPump.fun 的 Mayhem Mode 剩余时间,非此模式代币则返回空。
>tagsObject标签 / 审计类数据。
>>top10HoldingsPercentStringTop10 持仓占比(%)。
>>devHoldingsPercentStringDev 持仓占比(%)。
>>insidersPercentStringInsiders 占比(%)。
>>bundlersPercentStringBundlers 占比(%)。
>>snipersPercentStringSnipers 占比(%)。
>>freshWalletsPercentStringFresh wallets 占比(%)。
>>suspectedPhishingWalletPercentString疑似钓鱼钱包(%)。
>>totalHoldersString持币地址数量。
>socialObject社交媒体信息。
>>xStringX(Twitter)链接。
>>telegramStringTelegram 链接。
>>websiteString网站链接。
>>websiteTypeString官网类型。
>>dexScreenerPaidBooleanDEX Screener paid。
>>communityTakeoverBooleanCTO(社区接管)。
>>liveOnPumpFunBooleanLive on Pump.fun。
>bagsFeeClaimedBoolean是否 claim bag fee。
>apedString同车钱包数量。
>migratedBeginTimestampString迁移开始时间(ISO 8601)。
>migratedEndTimestampString迁移结束时间(ISO 8601)。
>creatorAddressString代币创建者钱包地址。

请求示例#

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"
      }
    ]
  }
}