Get Token List#

Retrieve the list of tokens matching specified filter criteria.

Request URL#

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

Request Parameters#

Parameter	Type	Required	Description
chainIndex	String	Yes	Chain unique identifier (e.g., `501` = Solana). Only single-chain queries are supported.
protocolId	String	No	Protocol ID filter. If omitted, returns all supported protocols.
sort	String	No	Sort field. Enum: `marketCapUsd`, `volumeUsd1h`, `txCount1h`, `createdTimestamp`. Default: `createdTimestamp`.
order	String	No	Sort order. Enum: `asc`, `desc`. Default: `desc`.
minAge	Integer	No	Minimum token age in minutes.
maxAge	Integer	No	Maximum token age in minutes.
minMarketCapUsd	String	No	Minimum market cap (USD).
maxMarketCapUsd	String	No	Maximum market cap (USD).
minVolumeUsd1h	String	No	Minimum 1h trading volume (USD).
stage	String	No	Token stage filter. Enum: `new`, `migrating_soon`, `migrated`.
limit	Integer	No	Number of results to return. Max: 30. Default: 30.
cursor	String	No	Pagination cursor from the previous response.

Response Parameters#

Parameter	Type	Description
cursor	String	Pagination cursor for the next page. Empty if no more data.
items	Array	Token list.
>chainIndex	String	Chain ID (e.g., `501` = Solana).
>protocolId	String	Protocol ID (e.g., `1` = PUMP_FUN).
>quoteTokenAddress	String	Quote token contract address.
>tokenContractAddress	String	Token contract address.
>symbol	String	Token symbol.
>name	String	Token name.
>logoUrl	String	Token logo URL.
>createdTimestamp	String	Token creation time (millisecond timestamp).
>market	Object	Market data.
>>marketCapUsd	String	Market cap (USD).
>>volumeUsd1h	String	1h trading volume (USD).
>>txCount1h	String	1h total transaction count.
>>buyTxCount1h	String	1h buy transaction count.
>>sellTxCount1h	String	1h sell transaction count.
>bondingPercent	String	Bonding curve progress (%).
>mayhemModeTimeRemaining	String	Pump.fun Mayhem Mode remaining time. Empty if not applicable.
>tags	Object	Audit / tag data.
>>top10HoldingsPercent	String	Top 10 holders' combined holdings (%).
>>devHoldingsPercent	String	Developer holdings (%).
>>insidersPercent	String	Insiders holdings (%).
>>bundlersPercent	String	Bundlers holdings (%).
>>snipersPercent	String	Snipers holdings (%).
>>freshWalletsPercent	String	Fresh wallets holdings (%).
>>suspectedPhishingWalletPercent	String	Suspected phishing wallets (%).
>>totalHolders	String	Total number of holder addresses.
>social	Object	Social media info.
>>x	String	X (Twitter) link.
>>telegram	String	Telegram link.
>>website	String	Website link.
>>websiteType	String	Website type identifier.
>>dexScreenerPaid	Boolean	Whether DEX Screener ads are active.
>>communityTakeover	Boolean	Community takeover (CTO) flag.
>>liveOnPumpFun	Boolean	Live on Pump.fun flag.
>bagsFeeClaimed	Boolean	Whether bags fee has been claimed.
>aped	String	Number of co-invested (aped) wallets.
>migratedBeginTimestamp	String	Migration start time (ISO 8601).
>migratedEndTimestamp	String	Migration end time (ISO 8601).
>creatorAddress	String	Token creator wallet address.

Get Supported Chains and Protocols

Get Token Details

Request Example#

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'

Response Example#

Json

{
  "code": "0",
  "msg": "",
  "data": {
    "cursor": "eyJsYXN0SWQiOiI3R2Y5Li4ucHVtcCJ9",
    "items": [
      {
        "chainIndex": "501",
        "protocolId": "1",
        "quoteTokenAddress": "11111111111111111111111111111111",
        "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": "",
        "migratedEndTimestamp": "",
        "creatorAddress": "3kXoZt...q1Re"
      }
    ]
  }
}

Get Supported Chains and Protocols

Get Token Details