CoinMarketCap Cryptocurrency API Documentation

Token

Comprehensive multi-market DEX trading and on-chain data covering hundreds of DEXs across Ethereum, Solana, BNB Chain, and more.

POST

https://pro-api.coinmarketcap.com

/v1/dex/tokens/trending/list

X-CMC_PRO_API_KEY (header)

Get list of trending tokens

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Market list request

DqueryMarketRequestDTO

platformIds

string

Platform IDs, comma separated

interval

string

Time interval

nextPageIndex

string

Next page cursor

pageSize

integer · int32

Page size

LeaderboardFilterDTO

The request parameters for querying the token leaderboard

sortBy

string

Sort field

sortType

string

Sort type: asc or desc

200

V1_DEX_Tokens_Trending_List_-_Response_Model

TrendingTokensResponseDTO · required

API_Status_Object

Standardized status object for API calls.

POST/v1/dex/tokens/trending/list

curl https://pro-api.coinmarketcap.com/v1/dex/tokens/trending/list \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'X-CMC_PRO_API_KEY: <api-key>' \
  --data '{
  "platformIds": "platformIds",
  "interval": "interval",
  "nextPageIndex": "nextPageIndex",
  "pageSize": 0,
  "filter": {
    "hideFourMeme": true,
    "hidePumpFun": true,
    "hideMoonshot": true,
    "auditPassed": true,
    "social": true,
    "minAge": 0,
    "maxAge": 0,
    "minMarketCap": 0,
    "maxMarketCap": 0,
    "minLiquidity": 0,
    "maxLiquidity": 0,
    "volume": [
      {
        "min": "min",
        "max": "max",
        "type": "type"
      }
    ],
    "txns": [
      {
        "min": "min",
        "max": "max",
        "type": "type"
      }
    ],
    "buys": [
      {
        "min": "min",
        "max": "max",
        "type": "type"
      }
    ],
    "sells": [
      {
        "min": "min",
        "max": "max",
        "type": "type"
      }
    ],
    "priceChange": [
      {
        "min": "min",
        "max": "max",
        "type": "type"
      }
    ],
    "boostType": "all, onlyBoost, hideBoost",
    "allFieldsEmpty": true
  },
  "sortBy": "sortBy",
  "sortType": "sortType"
}'

Example Request Body

{
  "platformIds": "platformIds",
  "interval": "interval",
  "nextPageIndex": "nextPageIndex",
  "pageSize": 0,
  "filter": {
    "hideFourMeme": true,
    "hidePumpFun": true,
    "hideMoonshot": true,
    "auditPassed": true,
    "social": true,
    "minAge": 0,
    "maxAge": 0,
    "minMarketCap": 0,
    "maxMarketCap": 0,
    "minLiquidity": 0,
    "maxLiquidity": 0,
    "volume": [
      {
        "min": "min",
        "max": "max",
        "type": "type"
      }
    ],
    "txns": [
      {
        "min": "min",
        "max": "max",
        "type": "type"
      }
    ],
    "buys": [
      {
        "min": "min",
        "max": "max",
        "type": "type"
      }
    ],
    "sells": [
      {
        "min": "min",
        "max": "max",
        "type": "type"
      }
    ],
    "priceChange": [
      {
        "min": "min",
        "max": "max",
        "type": "type"
      }
    ],
    "boostType": "all, onlyBoost, hideBoost",
    "allFieldsEmpty": true
  },
  "sortBy": "sortBy",
  "sortType": "sortType"
}

json

Example Responses

{
  "data": {
    "total": 0,
    "currentPage": 0,
    "pageSize": 0,
    "nextPageIndex": "nextPageIndex",
    "version": "version",
    "leaderboardList": [
      {
        "n": "n",
        "sym": "sym",
        "addr": "addr",
        "plt": "plt",
        "pid": 0,
        "pdex": "pdex",
        "pcid": 0,
        "web": "web",
        "tw": "tw",
        "tg": "tg",
        "lg": "lg",
        "pubAt": "pubAt",
        "lchAt": "lchAt",
        "fdv": "fdv",
        "mcap": "mcap",
        "liqUsd": "liqUsd",
        "liq": "liq",
        "hld": 0,
        "p": "p",
        "np": "np",
        "pt": "pt",
        "v24h": "v24h",
        "t24h": "t24h",
        "ch24h": "ch24h",
        "thr": "thr",
        "dhr": "dhr",
        "bcr": "bcr",
        "hcnt": 0,
        "tsrc": "tsrc",
        "sts": [
          {
            "tp": "24h",
            "vu": "123456.789",
            "txs": "1024",
            "nb": "678",
            "ns": "346",
            "bvu": "65432.12",
            "svu": "58024.67",
            "but": "431",
            "sut": "398",
            "pc": 3.51,
            "ut": "789"
          }
        ],
        "rl": "rl",
        "ts": "ts",
        "bs": "bs",
        "dec": 0,
        "sig": {
          "mtp": 0,
          "psc": 0
        },
        "beScore": 0,
        "beRank": 0,
        "pltA": "pltA",
        "ecs": 0,
        "tags": [
          "string"
        ]
      }
    ]
  },
  "status": {
    "timestamp": "2026-03-05T22:43:48.471Z",
    "error_code": 0,
    "error_message": "",
    "elapsed": 10,
    "credit_count": 1,
    "notice": "",
    "total_count": 8128
  }
}

json

application/json

Batch query tokens

POST

https://pro-api.coinmarketcap.com

/v1/dex/tokens/batch-query

X-CMC_PRO_API_KEY (header)

Query multiple tokens in one request

Batch query tokens › Headers

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Batch query tokens › Request Body

Batch token query request

DqueryBatchTokenRequestDTO

platform

string

Platform name

addresses

string[]

List of token addresses

Batch query tokens › Responses

200

V1_DEX_Tokens_Batch_Query_-_Response_Model

TokenDetailDTO[] · required

API_Status_Object

Standardized status object for API calls.

POST/v1/dex/tokens/batch-query

curl https://pro-api.coinmarketcap.com/v1/dex/tokens/batch-query \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'X-CMC_PRO_API_KEY: <api-key>' \
  --data '{
  "platform": "platform",
  "addresses": [
    "string"
  ]
}'

Example Request Body

{
  "platform": "platform",
  "addresses": [
    "string"
  ]
}

json

Example Responses

{
  "data": [
    {
      "n": "n",
      "sym": "sym",
      "addr": "addr",
      "plt": "plt",
      "pdex": "pdex",
      "pcid": 0,
      "pid": 0,
      "dec": 0,
      "crt": "crt",
      "own": "own",
      "rnc": "rnc",
      "web": "web",
      "tw": "tw",
      "tg": "tg",
      "lg": "lg",
      "pubAt": "pubAt",
      "lchAt": "lchAt",
      "fdv": "fdv",
      "mcap": "mcap",
      "ts": "ts",
      "bs": "bs",
      "cs": "cs",
      "liqUsd": "liqUsd",
      "liq": "liq",
      "hld": "hld",
      "p": "p",
      "ph24h": "ph24h",
      "pl24h": "pl24h",
      "pt": "pt",
      "fpt": "fpt",
      "fpct": "fpct",
      "bcr": 0,
      "sts": [
        {
          "tp": "24h",
          "vu": "123456.789",
          "txs": "1024",
          "nb": "678",
          "ns": "346",
          "bvu": "65432.12",
          "svu": "58024.67",
          "but": "431",
          "sut": "398",
          "pc": 3.51,
          "ut": "789"
        }
      ],
      "pls": [
        {
          "addr": "addr",
          "v24": "v24",
          "pubAt": "pubAt",
          "t0": {
            "addr": "addr",
            "lg": "lg",
            "n": "n",
            "sym": "sym",
            "liq": "liq",
            "liqUsd": "liqUsd"
          },
          "t1": {
            "addr": "addr",
            "lg": "lg",
            "n": "n",
            "sym": "sym",
            "liq": "liq",
            "liqUsd": "liqUsd"
          },
          "bidx": 0,
          "exid": 0,
          "exn": "exn",
          "liqUsd": "liqUsd",
          "fa": "fa",
          "lr": "lr",
          "br": "br",
          "top": true,
          "mi": true
        }
      ],
      "turl": "turl",
      "nps": "nps",
      "tsrc": "tsrc",
      "rl": "rl",
      "lf": 0,
      "cid": 0,
      "lmc": "lmc",
      "lsmc": "lsmc",
      "lsrcs": "lsrcs",
      "ltcs": "ltcs",
      "ltda": "ltda",
      "cexs": [
        {
          "id": 0,
          "slug": "slug",
          "n": "n",
          "lg": "lg",
          "wst": "wst",
          "cat": [
            "string"
          ]
        }
      ],
      "sig": {
        "mtp": 0,
        "psc": 0
      },
      "ecs": 0,
      "la": 0
    }
  ],
  "status": {
    "timestamp": "2026-03-05T22:43:48.471Z",
    "error_code": 0,
    "error_message": "",
    "elapsed": 10,
    "credit_count": 1,
    "notice": "",
    "total_count": 8128
  }
}

json

application/json

Batch get token prices

POST

https://pro-api.coinmarketcap.com

/v1/dex/token/price/batch

X-CMC_PRO_API_KEY (header)

Get prices for multiple tokens in one request

Batch get token prices › Headers

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Batch get token prices › Request Body

Batch price query request

DqueryBatchPriceRequestDTO

PlatformAddress[]

List of platform-address pairs

Batch get token prices › Responses

200

V1_DEX_Token_Price_Batch_-_Response_Model

TokenPriceDTO[] · required

API_Status_Object

Standardized status object for API calls.

POST/v1/dex/token/price/batch

curl https://pro-api.coinmarketcap.com/v1/dex/token/price/batch \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'X-CMC_PRO_API_KEY: <api-key>' \
  --data '{
  "tokens": [
    {
      "platform": "platform",
      "address": "address"
    }
  ]
}'

Example Request Body

{
  "tokens": [
    {
      "platform": "platform",
      "address": "address"
    }
  ]
}

json

Example Responses

{
  "data": [
    {
      "pid": 0,
      "pdex": "pdex",
      "pcid": 0,
      "a": "a",
      "n": "n",
      "sym": "sym",
      "lg": "lg",
      "p": 0,
      "pc1h": 0,
      "pc24h": 0,
      "pc7d": 0,
      "v24h": 0,
      "l": 0,
      "ts": "ts",
      "mc": 0,
      "fpt": "fpt",
      "fpct": "fpct"
    }
  ],
  "status": {
    "timestamp": "2026-03-05T22:43:48.471Z",
    "error_code": 0,
    "error_message": "",
    "elapsed": 10,
    "credit_count": 1,
    "notice": "",
    "total_count": 8128
  }
}

json

application/json

Get new tokens

POST

https://pro-api.coinmarketcap.com

/v1/dex/new/list

X-CMC_PRO_API_KEY (header)

Get list of newly launched tokens

Get new tokens › Headers

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Get new tokens › Request Body

Market list request

DqueryMarketRequestDTO

platformIds

string

Platform IDs, comma separated

interval

string

Time interval

nextPageIndex

string

Next page cursor

pageSize

integer · int32

Page size

LeaderboardFilterDTO

The request parameters for querying the token leaderboard

sortBy

string

Sort field

sortType

string

Sort type: asc or desc

Get new tokens › Responses

200

V1_DEX_New_List_-_Response_Model

NewTokenLeaderBoardResponseDTO · required

NewTokenLeaderboard response object

API_Status_Object

Standardized status object for API calls.

POST/v1/dex/new/list

curl https://pro-api.coinmarketcap.com/v1/dex/new/list \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'X-CMC_PRO_API_KEY: <api-key>' \
  --data '{
  "platformIds": "platformIds",
  "interval": "interval",
  "nextPageIndex": "nextPageIndex",
  "pageSize": 0,
  "filter": {
    "hideFourMeme": true,
    "hidePumpFun": true,
    "hideMoonshot": true,
    "auditPassed": true,
    "social": true,
    "minAge": 0,
    "maxAge": 0,
    "minMarketCap": 0,
    "maxMarketCap": 0,
    "minLiquidity": 0,
    "maxLiquidity": 0,
    "volume": [
      {
        "min": "min",
        "max": "max",
        "type": "type"
      }
    ],
    "txns": [
      {
        "min": "min",
        "max": "max",
        "type": "type"
      }
    ],
    "buys": [
      {
        "min": "min",
        "max": "max",
        "type": "type"
      }
    ],
    "sells": [
      {
        "min": "min",
        "max": "max",
        "type": "type"
      }
    ],
    "priceChange": [
      {
        "min": "min",
        "max": "max",
        "type": "type"
      }
    ],
    "boostType": "all, onlyBoost, hideBoost",
    "allFieldsEmpty": true
  },
  "sortBy": "sortBy",
  "sortType": "sortType"
}'

Example Request Body

{
  "platformIds": "platformIds",
  "interval": "interval",
  "nextPageIndex": "nextPageIndex",
  "pageSize": 0,
  "filter": {
    "hideFourMeme": true,
    "hidePumpFun": true,
    "hideMoonshot": true,
    "auditPassed": true,
    "social": true,
    "minAge": 0,
    "maxAge": 0,
    "minMarketCap": 0,
    "maxMarketCap": 0,
    "minLiquidity": 0,
    "maxLiquidity": 0,
    "volume": [
      {
        "min": "min",
        "max": "max",
        "type": "type"
      }
    ],
    "txns": [
      {
        "min": "min",
        "max": "max",
        "type": "type"
      }
    ],
    "buys": [
      {
        "min": "min",
        "max": "max",
        "type": "type"
      }
    ],
    "sells": [
      {
        "min": "min",
        "max": "max",
        "type": "type"
      }
    ],
    "priceChange": [
      {
        "min": "min",
        "max": "max",
        "type": "type"
      }
    ],
    "boostType": "all, onlyBoost, hideBoost",
    "allFieldsEmpty": true
  },
  "sortBy": "sortBy",
  "sortType": "sortType"
}

json

Example Responses

{
  "data": {
    "leaderboardList": [
      {
        "n": "n",
        "sym": "sym",
        "addr": "addr",
        "plt": "plt",
        "pid": 0,
        "pdex": "pdex",
        "pcid": 0,
        "web": "web",
        "tw": "tw",
        "tg": "tg",
        "lg": "lg",
        "pubAt": "pubAt",
        "lchAt": "lchAt",
        "fdv": "fdv",
        "mcap": "mcap",
        "liqUsd": "liqUsd",
        "liq": "liq",
        "hld": 0,
        "p": "p",
        "np": "np",
        "pt": "pt",
        "v24h": "v24h",
        "t24h": "t24h",
        "ch24h": "ch24h",
        "thr": "thr",
        "dhr": "dhr",
        "bcr": "bcr",
        "hcnt": 0,
        "tsrc": "tsrc",
        "sts": [
          {
            "tp": "24h",
            "vu": "123456.789",
            "txs": "1024",
            "nb": "678",
            "ns": "346",
            "bvu": "65432.12",
            "svu": "58024.67",
            "but": "431",
            "sut": "398",
            "pc": 3.51,
            "ut": "789"
          }
        ],
        "rl": "rl",
        "ts": "ts",
        "bs": "bs",
        "dec": 0,
        "sig": {
          "mtp": 0,
          "psc": 0
        },
        "beScore": 0,
        "beRank": 0,
        "pltA": "pltA",
        "ecs": 0,
        "tags": [
          "string"
        ]
      }
    ],
    "total": "total",
    "hasNextPage": true,
    "lastUpdateTime": "lastUpdateTime",
    "nextPageIndex": "nextPageIndex"
  },
  "status": {
    "timestamp": "2026-03-05T22:43:48.471Z",
    "error_code": 0,
    "error_message": "",
    "elapsed": 10,
    "credit_count": 1,
    "notice": "",
    "total_count": 8128
  }
}

json

application/json

Get meme tokens

POST

https://pro-api.coinmarketcap.com

/v1/dex/meme/list

X-CMC_PRO_API_KEY (header)

Get list of meme tokens

Get meme tokens › Headers

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Get meme tokens › Request Body

Meme coin request

DqueryMemeRequestDTO

protocol

integer · int32

Protocol code

exclusive

integer · int32

Binance exclusive flag

limit

integer · int32

Result limit

MemeCoinFilterDTO

Filter criteria for meme coins

MemeCoinFilterDTO

Filter criteria for meme coins

MemeCoinFilterDTO

Filter criteria for meme coins

Get meme tokens › Responses

200

V1_DEX_Meme_List_-_Response_Model

MemeCoinResponseDTO · required

Response object containing categorized meme coin results

API_Status_Object

Standardized status object for API calls.

POST/v1/dex/meme/list

curl https://pro-api.coinmarketcap.com/v1/dex/meme/list \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'X-CMC_PRO_API_KEY: <api-key>' \
  --data '{
  "protocol": 0,
  "exclusive": 0,
  "limit": 0,
  "newCreationFilter": {
    "topHoldersLessThan": true,
    "devSoldAll": true,
    "devStillHolding": true,
    "social": true,
    "minAge": 0,
    "maxAge": 0,
    "minMarketCap": 0,
    "maxMarketCap": 0,
    "minLiquidity": 0,
    "maxLiquidity": 0,
    "minBondingCurve": 0,
    "maxBondingCurve": 0,
    "minDevHolding": 0,
    "maxDevHolding": 0,
    "minHolders": 0,
    "maxHolders": 0,
    "minVolume": 0,
    "maxVolume": 0,
    "minTxns": 0,
    "maxTxns": 0,
    "minBuys": 0,
    "maxBuys": 0,
    "minSells": 0,
    "maxSells": 0,
    "minTop10Holding": 0,
    "maxTop10Holding": 0,
    "minSnipers": 0,
    "maxSnipers": 0,
    "minInsiders": 0,
    "maxInsiders": 0
  },
  "aboutGraduateFilter": {
    "topHoldersLessThan": true,
    "devSoldAll": true,
    "devStillHolding": true,
    "social": true,
    "minAge": 0,
    "maxAge": 0,
    "minMarketCap": 0,
    "maxMarketCap": 0,
    "minLiquidity": 0,
    "maxLiquidity": 0,
    "minBondingCurve": 0,
    "maxBondingCurve": 0,
    "minDevHolding": 0,
    "maxDevHolding": 0,
    "minHolders": 0,
    "maxHolders": 0,
    "minVolume": 0,
    "maxVolume": 0,
    "minTxns": 0,
    "maxTxns": 0,
    "minBuys": 0,
    "maxBuys": 0,
    "minSells": 0,
    "maxSells": 0,
    "minTop10Holding": 0,
    "maxTop10Holding": 0,
    "minSnipers": 0,
    "maxSnipers": 0,
    "minInsiders": 0,
    "maxInsiders": 0
  },
  "graduateFilter": {
    "topHoldersLessThan": true,
    "devSoldAll": true,
    "devStillHolding": true,
    "social": true,
    "minAge": 0,
    "maxAge": 0,
    "minMarketCap": 0,
    "maxMarketCap": 0,
    "minLiquidity": 0,
    "maxLiquidity": 0,
    "minBondingCurve": 0,
    "maxBondingCurve": 0,
    "minDevHolding": 0,
    "maxDevHolding": 0,
    "minHolders": 0,
    "maxHolders": 0,
    "minVolume": 0,
    "maxVolume": 0,
    "minTxns": 0,
    "maxTxns": 0,
    "minBuys": 0,
    "maxBuys": 0,
    "minSells": 0,
    "maxSells": 0,
    "minTop10Holding": 0,
    "maxTop10Holding": 0,
    "minSnipers": 0,
    "maxSnipers": 0,
    "minInsiders": 0,
    "maxInsiders": 0
  }
}'

Example Request Body

{
  "protocol": 0,
  "exclusive": 0,
  "limit": 0,
  "newCreationFilter": {
    "topHoldersLessThan": true,
    "devSoldAll": true,
    "devStillHolding": true,
    "social": true,
    "minAge": 0,
    "maxAge": 0,
    "minMarketCap": 0,
    "maxMarketCap": 0,
    "minLiquidity": 0,
    "maxLiquidity": 0,
    "minBondingCurve": 0,
    "maxBondingCurve": 0,
    "minDevHolding": 0,
    "maxDevHolding": 0,
    "minHolders": 0,
    "maxHolders": 0,
    "minVolume": 0,
    "maxVolume": 0,
    "minTxns": 0,
    "maxTxns": 0,
    "minBuys": 0,
    "maxBuys": 0,
    "minSells": 0,
    "maxSells": 0,
    "minTop10Holding": 0,
    "maxTop10Holding": 0,
    "minSnipers": 0,
    "maxSnipers": 0,
    "minInsiders": 0,
    "maxInsiders": 0
  },
  "aboutGraduateFilter": {
    "topHoldersLessThan": true,
    "devSoldAll": true,
    "devStillHolding": true,
    "social": true,
    "minAge": 0,
    "maxAge": 0,
    "minMarketCap": 0,
    "maxMarketCap": 0,
    "minLiquidity": 0,
    "maxLiquidity": 0,
    "minBondingCurve": 0,
    "maxBondingCurve": 0,
    "minDevHolding": 0,
    "maxDevHolding": 0,
    "minHolders": 0,
    "maxHolders": 0,
    "minVolume": 0,
    "maxVolume": 0,
    "minTxns": 0,
    "maxTxns": 0,
    "minBuys": 0,
    "maxBuys": 0,
    "minSells": 0,
    "maxSells": 0,
    "minTop10Holding": 0,
    "maxTop10Holding": 0,
    "minSnipers": 0,
    "maxSnipers": 0,
    "minInsiders": 0,
    "maxInsiders": 0
  },
  "graduateFilter": {
    "topHoldersLessThan": true,
    "devSoldAll": true,
    "devStillHolding": true,
    "social": true,
    "minAge": 0,
    "maxAge": 0,
    "minMarketCap": 0,
    "maxMarketCap": 0,
    "minLiquidity": 0,
    "maxLiquidity": 0,
    "minBondingCurve": 0,
    "maxBondingCurve": 0,
    "minDevHolding": 0,
    "maxDevHolding": 0,
    "minHolders": 0,
    "maxHolders": 0,
    "minVolume": 0,
    "maxVolume": 0,
    "minTxns": 0,
    "maxTxns": 0,
    "minBuys": 0,
    "maxBuys": 0,
    "minSells": 0,
    "maxSells": 0,
    "minTop10Holding": 0,
    "maxTop10Holding": 0,
    "minSnipers": 0,
    "maxSnipers": 0,
    "minInsiders": 0,
    "maxInsiders": 0
  }
}

json

Example Responses

{
  "data": {
    "newCreations": [
      {
        "plt": 0,
        "cid": "cid",
        "pr": 0,
        "pn": "pn",
        "it": "it",
        "addr": "addr",
        "n": "n",
        "sym": "sym",
        "lg": "lg",
        "tw": "tw",
        "web": "web",
        "tg": "tg",
        "pt": 0,
        "pubAt": 0,
        "dec": 0,
        "tp": "tp",
        "bc": 0,
        "mcap": 0,
        "liq": 0,
        "vu": 0,
        "np": 0,
        "p": 0,
        "txs": 0,
        "nb": 0,
        "ns": 0,
        "htp": 0,
        "hdp": 0,
        "hsp": 0,
        "hip": 0,
        "dsp": 0,
        "dmc": 0,
        "ms": 0,
        "mt": 0,
        "md": "md",
        "h": 0,
        "ecs": 0
      }
    ],
    "aboutGraduates": [
      {
        "plt": 0,
        "cid": "cid",
        "pr": 0,
        "pn": "pn",
        "it": "it",
        "addr": "addr",
        "n": "n",
        "sym": "sym",
        "lg": "lg",
        "tw": "tw",
        "web": "web",
        "tg": "tg",
        "pt": 0,
        "pubAt": 0,
        "dec": 0,
        "tp": "tp",
        "bc": 0,
        "mcap": 0,
        "liq": 0,
        "vu": 0,
        "np": 0,
        "p": 0,
        "txs": 0,
        "nb": 0,
        "ns": 0,
        "htp": 0,
        "hdp": 0,
        "hsp": 0,
        "hip": 0,
        "dsp": 0,
        "dmc": 0,
        "ms": 0,
        "mt": 0,
        "md": "md",
        "h": 0,
        "ecs": 0
      }
    ],
    "graduates": [
      {
        "plt": 0,
        "cid": "cid",
        "pr": 0,
        "pn": "pn",
        "it": "it",
        "addr": "addr",
        "n": "n",
        "sym": "sym",
        "lg": "lg",
        "tw": "tw",
        "web": "web",
        "tg": "tg",
        "pt": 0,
        "pubAt": 0,
        "dec": 0,
        "tp": "tp",
        "bc": 0,
        "mcap": 0,
        "liq": 0,
        "vu": 0,
        "np": 0,
        "p": 0,
        "txs": 0,
        "nb": 0,
        "ns": 0,
        "htp": 0,
        "hdp": 0,
        "hsp": 0,
        "hip": 0,
        "dsp": 0,
        "dmc": 0,
        "ms": 0,
        "mt": 0,
        "md": "md",
        "h": 0,
        "ecs": 0
      }
    ]
  },
  "status": {
    "timestamp": "2026-03-05T22:43:48.471Z",
    "error_code": 0,
    "error_message": "",
    "elapsed": 10,
    "credit_count": 1,
    "notice": "",
    "total_count": 8128
  }
}

json

application/json

Get top gainers and losers

POST

https://pro-api.coinmarketcap.com

/v1/dex/gainer-loser/list

X-CMC_PRO_API_KEY (header)

Get list of top gainer and loser tokens

Get top gainers and losers › Headers

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Get top gainers and losers › Request Body

Market list request

DqueryMarketRequestDTO

platformIds

string

Platform IDs, comma separated

interval

string

Time interval

nextPageIndex

string

Next page cursor

pageSize

integer · int32

Page size

LeaderboardFilterDTO

The request parameters for querying the token leaderboard

sortBy

string

Sort field

sortType

string

Sort type: asc or desc

Get top gainers and losers › Responses

200

V1_DEX_Gainer_Loser_List_-_Response_Model

GainerLeaderBoardResponseDTO · required

Response object for the Gainer Leaderboard API

API_Status_Object

Standardized status object for API calls.

POST/v1/dex/gainer-loser/list

curl https://pro-api.coinmarketcap.com/v1/dex/gainer-loser/list \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'X-CMC_PRO_API_KEY: <api-key>' \
  --data '{
  "platformIds": "platformIds",
  "interval": "interval",
  "nextPageIndex": "nextPageIndex",
  "pageSize": 0,
  "filter": {
    "hideFourMeme": true,
    "hidePumpFun": true,
    "hideMoonshot": true,
    "auditPassed": true,
    "social": true,
    "minAge": 0,
    "maxAge": 0,
    "minMarketCap": 0,
    "maxMarketCap": 0,
    "minLiquidity": 0,
    "maxLiquidity": 0,
    "volume": [
      {
        "min": "min",
        "max": "max",
        "type": "type"
      }
    ],
    "txns": [
      {
        "min": "min",
        "max": "max",
        "type": "type"
      }
    ],
    "buys": [
      {
        "min": "min",
        "max": "max",
        "type": "type"
      }
    ],
    "sells": [
      {
        "min": "min",
        "max": "max",
        "type": "type"
      }
    ],
    "priceChange": [
      {
        "min": "min",
        "max": "max",
        "type": "type"
      }
    ],
    "boostType": "all, onlyBoost, hideBoost",
    "allFieldsEmpty": true
  },
  "sortBy": "sortBy",
  "sortType": "sortType"
}'

Example Request Body

{
  "platformIds": "platformIds",
  "interval": "interval",
  "nextPageIndex": "nextPageIndex",
  "pageSize": 0,
  "filter": {
    "hideFourMeme": true,
    "hidePumpFun": true,
    "hideMoonshot": true,
    "auditPassed": true,
    "social": true,
    "minAge": 0,
    "maxAge": 0,
    "minMarketCap": 0,
    "maxMarketCap": 0,
    "minLiquidity": 0,
    "maxLiquidity": 0,
    "volume": [
      {
        "min": "min",
        "max": "max",
        "type": "type"
      }
    ],
    "txns": [
      {
        "min": "min",
        "max": "max",
        "type": "type"
      }
    ],
    "buys": [
      {
        "min": "min",
        "max": "max",
        "type": "type"
      }
    ],
    "sells": [
      {
        "min": "min",
        "max": "max",
        "type": "type"
      }
    ],
    "priceChange": [
      {
        "min": "min",
        "max": "max",
        "type": "type"
      }
    ],
    "boostType": "all, onlyBoost, hideBoost",
    "allFieldsEmpty": true
  },
  "sortBy": "sortBy",
  "sortType": "sortType"
}

json

Example Responses

{
  "data": {
    "leaderboardList": [
      {
        "n": "n",
        "sym": "sym",
        "addr": "addr",
        "plt": "plt",
        "pid": 0,
        "pdex": "pdex",
        "pcid": 0,
        "web": "web",
        "tw": "tw",
        "tg": "tg",
        "lg": "lg",
        "pubAt": "pubAt",
        "lchAt": "lchAt",
        "fdv": "fdv",
        "mcap": "mcap",
        "liqUsd": "liqUsd",
        "liq": "liq",
        "hld": 0,
        "p": "p",
        "np": "np",
        "pt": "pt",
        "v24h": "v24h",
        "t24h": "t24h",
        "ch24h": "ch24h",
        "thr": "thr",
        "dhr": "dhr",
        "bcr": "bcr",
        "hcnt": 0,
        "tsrc": "tsrc",
        "sts": [
          {
            "tp": "24h",
            "vu": "123456.789",
            "txs": "1024",
            "nb": "678",
            "ns": "346",
            "bvu": "65432.12",
            "svu": "58024.67",
            "but": "431",
            "sut": "398",
            "pc": 3.51,
            "ut": "789"
          }
        ],
        "rl": "rl",
        "ts": "ts",
        "bs": "bs",
        "dec": 0,
        "sig": {
          "mtp": 0,
          "psc": 0
        },
        "beScore": 0,
        "beRank": 0,
        "pltA": "pltA",
        "ecs": 0,
        "tags": [
          "string"
        ]
      }
    ],
    "pageNum": 0,
    "pageSize": 0,
    "total": "total",
    "hasNextPage": true,
    "lastUpdateTime": 0,
    "nextPageIndex": "nextPageIndex"
  },
  "status": {
    "timestamp": "2026-03-05T22:43:48.471Z",
    "error_code": 0,
    "error_message": "",
    "elapsed": 10,
    "credit_count": 1,
    "notice": "",
    "total_count": 8128
  }
}

json

application/json

Pairs Listings Latest

GET

https://pro-api.coinmarketcap.com

/v4/dex/spot-pairs/latest

X-CMC_PRO_API_KEY (header)

Returns a paginated list of all active dex spot pairs with latest market data. Use the "convert" option to return market values in multiple fiat and cryptocurrency conversions in the same call.

Available with no API key

Call this endpoint keyless - no API key, no signup. Prefix the path with /public-api: https://pro-api.coinmarketcap.com/public-api/v4/dex/spot-pairs/latest. See the Keyless Public API for the full list, rate limits, and examples.

Pairs Listings Latest › query Parameters

network_id

string

One or more comma-separated CoinMarketCap cryptocurrency network ids.

network_slug

string

Alternatively, one or more comma-separated network names in URL friendly shorthand slug format (all lowercase, spaces replaced with hyphens). At least one id or slug is required.

dex_id

string

One or more comma-separated CoinMarketCap dex exchange ids

dex_slug

string

Alternatively, one or more comma-separated dex exchange names in URL friendly shorthand slug format (all lowercase, spaces replaced with hyphens). At least one id or slug is required.

base_asset_id

string

One or more comma-separated CoinMarketCap cryptocurrency ids.

base_asset_symbol

string

Alternatively, one or more comma-separated network symbol in URL friendly shorthand slug format (all lowercase, spaces replaced with hyphens).At least one id or slug is required.

base_asset_contract_address

string

Alternatively, one base asset contract address in URL friendly shorthand slug format (all lowercase, spaces replaced with hyphens).At least one id or slug is required.

base_asset_ucid

string

One or more comma-separated CoinMarketCap cryptocurrency IDs.

quote_asset_id

string

One or more comma-separated CoinMarketCap cryptocurrency ids.

quote_asset_symbol

string

Alternatively, one or more comma-separated network symbol in URL friendly shorthand slug format (all lowercase, spaces replaced with hyphens). At least one id or slug is required.

quote_asset_contract_address

string

Alternatively, one quote asset contract address in URL friendly shorthand slug format (all lowercase, spaces replaced with hyphens). At least one id or slug is required.

quote_asset_ucid

string

One or more comma-separated CoinMarketCap cryptocurrency IDs.

scroll_id

string

After your initial query, the API responds with the initial set of results and a scroll_ids. To retrieve the next set of results, provide this scroll_id of the last JSON with your follow-up request. scroll_id is an alternative to traditional pagination techniques.

limit

string

Optionally specify the number of results to return. Use this parameter and the start parameter to determine your own pagination size.

liquidity_min

string

Optionally specify a threshold of minimum liquidity to filter results by.

liquidity_max

string

Optionally specify a threshold of maximum liquidity to filter results by.

volume_24h_min

string

Optionally specify a threshold of minimum 24 hour USD volume to filter results by.

volume_24h_max

string

Optionally specify a threshold of maximum 24 hour USD volume to filter results by.

no_of_transactions_24h_min

string

Optionally specify a threshold of minimum 24h no. of transactions to filter results by.

no_of_transactions_24h_max

string

Optionally specify a threshold of maximum 24h no. of transactions to filter results by.

percent_change_24h_min

string

Optionally specify a threshold of minimum 24 hour percent change to filter results by.

percent_change_24h_max

string

Optionally specify a threshold of maximum 24 hour percent change to filter results by.

sort

string

Default:"volume_24h" Valid values: "volume_24h" "liquidity" "no_of_transactions_24h" "percent_change_24h" // todo Sort the list of dex spot pairs by.

sort_dir

string

Default:"desc" Valid values: "desc" "asc" The direction in which to order dex spot pairs against the specified sort.

aux

string

Default:"" Valid values: "pool_created" "percent_pooled_base_asset" "num_transactions_24h" "pool_base_asset" "pool_quote_asset" "24h_volume_quote_asset" "total_supply_quote_asset" "total_supply_base_asset" "holders" "buy_tax" "sell_tax" "security_scan" "24h_no_of_buys" "24h_no_of_sells" "24h_buy_volume" "24h_sell_volume" Optionally specify a comma-separated list of supplemental data fields to return.

reverse_order

string

Pass true to invert the order of a spot pair. For example, a trading pair is set up as Token B/Token A in the contract and is commonly referred to as Token A/Token B. Using reverse_order would change the order to reflect the true Token B/Token A pairing as it exists in the pool.

convert_id

string

Optionally calculate market quotes by CoinMarketCap ID instead of symbol. This option is identical to convert outside of ID format. Ex: convert_id=1,2781 would replace convert=BTC,USD in your query. This parameter cannot be used when convert is used.

Pairs Listings Latest › Headers

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Pairs Listings Latest › Responses

200

V4_DEX_Spot_Pairs_Latest_-_Response_Model

DexSpotPairDTO[] · required

API_Status_Object

Standardized status object for API calls.

GET/v4/dex/spot-pairs/latest

curl https://pro-api.coinmarketcap.com/v4/dex/spot-pairs/latest \
  --header 'X-CMC_PRO_API_KEY: <api-key>'

Example Responses

{
  "data": [
    {
      "quote": [
        {
          "price": 0,
          "liquidity": 0,
          "convert_id": "convert_id",
          "price_by_quote_asset": 0,
          "last_updated": "2024-08-25T15:00:00Z",
          "volume_24h": 0,
          "percent_change_price_1h": 0,
          "percent_change_price_24h": 0,
          "fully_diluted_value": 0,
          "24h_buy_volume": 0,
          "24h_sell_volume": 0
        }
      ],
      "contract_address": "contract_address",
      "name": "name",
      "base_asset_id": "base_asset_id",
      "base_asset_ucid": "base_asset_ucid",
      "base_asset_name": "base_asset_name",
      "base_asset_symbol": "base_asset_symbol",
      "base_asset_contract_address": "base_asset_contract_address",
      "quote_asset_id": "quote_asset_id",
      "quote_asset_ucid": "quote_asset_ucid",
      "quote_asset_name": "quote_asset_name",
      "quote_asset_symbol": "quote_asset_symbol",
      "quote_asset_contract_address": "quote_asset_contract_address",
      "dex_id": "dex_id",
      "dex_slug": "dex_slug",
      "network_id": "network_id",
      "network_slug": "network_slug",
      "last_updated": "2024-08-25T15:00:00Z",
      "created_at": "2024-08-25T15:00:00Z",
      "num_transactions_24h": 0,
      "holders": 0,
      "24h_no_of_buys": 0,
      "24h_no_of_sells": 0,
      "pool_created": "2024-08-25T15:00:00Z",
      "buy_tax": 0,
      "sell_tax": 0,
      "security_scan": [
        {
          "third_party": {
            "open_source": true,
            "proxy": true,
            "mintable": true,
            "can_take_back_ownership": true,
            "owner_change_balance": true,
            "hidden_owner": true,
            "self_destruct": true,
            "external_call": true,
            "cannot_buy": true,
            "cannot_sell_all": true,
            "slippage_modifiable": true,
            "honeypot": true,
            "transfer_pausable": true,
            "blacklisted": true,
            "whitelisted": true,
            "in_dex": true,
            "anti_whale": true,
            "anti_whale_modifiable": true,
            "trading_cool_down": true,
            "personal_slippage_modifiable": true,
            "trust_list": true,
            "true_token": true,
            "airdrop_scam": true
          },
          "aggregated": {
            "contract_verified": true,
            "honeypot": true
          }
        }
      ],
      "pool_base_asset": 0,
      "pool_quote_asset": 0,
      "percent_pooled_base_asset": 0,
      "24h_volume_quote_asset": 0,
      "total_supply_quote_asset": 0,
      "total_supply_base_asset": 0,
      "date_launched": "2024-08-25T15:00:00Z",
      "scroll_id": "scroll_id"
    }
  ],
  "status": {
    "timestamp": "2026-03-05T22:43:48.471Z",
    "error_code": 0,
    "error_message": "",
    "elapsed": 10,
    "credit_count": 1,
    "notice": "",
    "total_count": 8128
  }
}

json

application/json

Quotes Latest

GET

https://pro-api.coinmarketcap.com

/v4/dex/pairs/quotes/latest

X-CMC_PRO_API_KEY (header)

Returns the latest market quote for 1 or more spot pairs. Use the "convert" option to return market values in multiple fiat and cryptocurrency conversions in the same call.

Available with no API key

Call this endpoint keyless - no API key, no signup. Prefix the path with /public-api: https://pro-api.coinmarketcap.com/public-api/v4/dex/pairs/quotes/latest. See the Keyless Public API for the full list, rate limits, and examples.

Quotes Latest › query Parameters

contract_address

string

One or more comma-separated contract addresses.

network_id

string

One or more CoinMarketCap cryptocurrency network ids

network_slug

string

Alternatively, one network names in URL friendly shorthand "slug" format (all lowercase, spaces replaced with hyphens).

aux

string

convert_id

string

skip_invalid

string

Pass true to relax request validation rules. When requesting records on multiple spot pairs an error is returned if no match is found for 1 or more requested spot pairs. If set to true, invalid lookups will be skipped allowing valid spot pairs to still be returned.

reverse_order

string

Quotes Latest › Headers

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Quotes Latest › Responses

200

V4_DEX_Pairs_Quotes_Latest_-_Response_Model

DexParisQuotesDTO[] · required

API_Status_Object

Standardized status object for API calls.

GET/v4/dex/pairs/quotes/latest

curl https://pro-api.coinmarketcap.com/v4/dex/pairs/quotes/latest \
  --header 'X-CMC_PRO_API_KEY: <api-key>'

Example Responses

{
  "data": [
    {
      "quote": [
        {
          "price": 0,
          "liquidity": 0,
          "convert_id": "convert_id",
          "price_by_quote_asset": 0,
          "last_updated": "2024-08-25T15:00:00Z",
          "volume_24h": 0,
          "percent_change_price_1h": 0,
          "percent_change_price_24h": 0,
          "fully_diluted_value": 0,
          "24h_buy_volume": 0,
          "24h_sell_volume": 0
        }
      ],
      "contract_address": "contract_address",
      "name": "name",
      "base_asset_id": "base_asset_id",
      "base_asset_ucid": "base_asset_ucid",
      "base_asset_name": "base_asset_name",
      "base_asset_symbol": "base_asset_symbol",
      "base_asset_contract_address": "base_asset_contract_address",
      "quote_asset_id": "quote_asset_id",
      "quote_asset_ucid": "quote_asset_ucid",
      "quote_asset_name": "quote_asset_name",
      "quote_asset_symbol": "quote_asset_symbol",
      "quote_asset_contract_address": "quote_asset_contract_address",
      "dex_id": "dex_id",
      "dex_slug": "dex_slug",
      "network_id": "network_id",
      "network_slug": "network_slug",
      "last_updated": "2024-08-25T15:00:00Z",
      "created_at": "2024-08-25T15:00:00Z",
      "num_transactions_24h": 0,
      "holders": 0,
      "24h_no_of_buys": 0,
      "24h_no_of_sells": 0,
      "pool_created": "2024-08-25T15:00:00Z",
      "buy_tax": 0,
      "sell_tax": 0,
      "security_scan": [
        {
          "third_party": {
            "open_source": true,
            "proxy": true,
            "mintable": true,
            "can_take_back_ownership": true,
            "owner_change_balance": true,
            "hidden_owner": true,
            "self_destruct": true,
            "external_call": true,
            "cannot_buy": true,
            "cannot_sell_all": true,
            "slippage_modifiable": true,
            "honeypot": true,
            "transfer_pausable": true,
            "blacklisted": true,
            "whitelisted": true,
            "in_dex": true,
            "anti_whale": true,
            "anti_whale_modifiable": true,
            "trading_cool_down": true,
            "personal_slippage_modifiable": true,
            "trust_list": true,
            "true_token": true,
            "airdrop_scam": true
          },
          "aggregated": {
            "contract_verified": true,
            "honeypot": true
          }
        }
      ],
      "pool_base_asset": 0,
      "pool_quote_asset": 0,
      "percent_pooled_base_asset": 0,
      "24h_volume_quote_asset": 0,
      "total_supply_quote_asset": 0,
      "total_supply_base_asset": 0,
      "date_launched": "2024-08-25T15:00:00Z"
    }
  ],
  "status": {
    "timestamp": "2026-03-05T22:43:48.471Z",
    "error_code": 0,
    "error_message": "",
    "elapsed": 10,
    "credit_count": 1,
    "notice": "",
    "total_count": 8128
  }
}

json

application/json

Get token detail

GET

https://pro-api.coinmarketcap.com

/v1/dex/token

X-CMC_PRO_API_KEY (header)

Get detailed information for a specific token

Available with no API key

Call this endpoint keyless - no API key, no signup. Prefix the path with /public-api: https://pro-api.coinmarketcap.com/public-api/v1/dex/token. See the Keyless Public API for the full list, rate limits, and examples.

Get token detail › query Parameters

platform

string

Platform name

address

string

Token address

Get token detail › Headers

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Get token detail › Responses

200

V1_DEX_Token_-_Response_Model

TokenDetailDTO · required

Detailed token information

API_Status_Object

Standardized status object for API calls.

GET/v1/dex/token

curl https://pro-api.coinmarketcap.com/v1/dex/token \
  --header 'X-CMC_PRO_API_KEY: <api-key>'

Example Responses

{
  "data": {
    "n": "n",
    "sym": "sym",
    "addr": "addr",
    "plt": "plt",
    "pdex": "pdex",
    "pcid": 0,
    "pid": 0,
    "dec": 0,
    "crt": "crt",
    "own": "own",
    "rnc": "rnc",
    "web": "web",
    "tw": "tw",
    "tg": "tg",
    "lg": "lg",
    "pubAt": "pubAt",
    "lchAt": "lchAt",
    "fdv": "fdv",
    "mcap": "mcap",
    "ts": "ts",
    "bs": "bs",
    "cs": "cs",
    "liqUsd": "liqUsd",
    "liq": "liq",
    "hld": "hld",
    "p": "p",
    "ph24h": "ph24h",
    "pl24h": "pl24h",
    "pt": "pt",
    "fpt": "fpt",
    "fpct": "fpct",
    "bcr": 0,
    "sts": [
      {
        "tp": "24h",
        "vu": "123456.789",
        "txs": "1024",
        "nb": "678",
        "ns": "346",
        "bvu": "65432.12",
        "svu": "58024.67",
        "but": "431",
        "sut": "398",
        "pc": 3.51,
        "ut": "789"
      }
    ],
    "pls": [
      {
        "addr": "addr",
        "v24": "v24",
        "pubAt": "pubAt",
        "t0": {
          "addr": "addr",
          "lg": "lg",
          "n": "n",
          "sym": "sym",
          "liq": "liq",
          "liqUsd": "liqUsd"
        },
        "t1": {
          "addr": "addr",
          "lg": "lg",
          "n": "n",
          "sym": "sym",
          "liq": "liq",
          "liqUsd": "liqUsd"
        },
        "bidx": 0,
        "exid": 0,
        "exn": "exn",
        "liqUsd": "liqUsd",
        "fa": "fa",
        "lr": "lr",
        "br": "br",
        "top": true,
        "mi": true
      }
    ],
    "turl": "turl",
    "nps": "nps",
    "tsrc": "tsrc",
    "rl": "rl",
    "lf": 0,
    "cid": 0,
    "lmc": "lmc",
    "lsmc": "lsmc",
    "lsrcs": "lsrcs",
    "ltcs": "ltcs",
    "ltda": "ltda",
    "cexs": [
      {
        "id": 0,
        "slug": "slug",
        "n": "n",
        "lg": "lg",
        "wst": "wst",
        "cat": [
          "string"
        ]
      }
    ],
    "sig": {
      "mtp": 0,
      "psc": 0
    },
    "ecs": 0,
    "la": 0
  },
  "status": {
    "timestamp": "2026-03-05T22:43:48.471Z",
    "error_code": 0,
    "error_message": "",
    "elapsed": 10,
    "credit_count": 1,
    "notice": "",
    "total_count": 8128
  }
}

json

application/json

Get token price

GET

https://pro-api.coinmarketcap.com

/v1/dex/token/price

X-CMC_PRO_API_KEY (header)

Get current price for a specific token

Available with no API key

Call this endpoint keyless - no API key, no signup. Prefix the path with /public-api: https://pro-api.coinmarketcap.com/public-api/v1/dex/token/price. See the Keyless Public API for the full list, rate limits, and examples.

Get token price › query Parameters

platform

string

Platform name

address

string

Token address

Get token price › Headers

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Get token price › Responses

200

V1_DEX_Token_Price_-_Response_Model

TokenPriceDTO · required

Token price information

API_Status_Object

Standardized status object for API calls.

Get token pools

GET

https://pro-api.coinmarketcap.com

/v1/dex/token/pools

X-CMC_PRO_API_KEY (header)

Get all pools for a specific token

Available with no API key

Call this endpoint keyless - no API key, no signup. Prefix the path with /public-api: https://pro-api.coinmarketcap.com/public-api/v1/dex/token/pools. See the Keyless Public API for the full list, rate limits, and examples.

Get token pools › query Parameters

platform

string

Platform name

address

string

Token address

size

integer · int32

Default: 20

Get token pools › Headers

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Get token pools › Responses

200

V1_DEX_Token_Pools_-_Response_Model

TokenTopPoolDTO[] · required

API_Status_Object

Standardized status object for API calls.

GET/v1/dex/token/pools

curl https://pro-api.coinmarketcap.com/v1/dex/token/pools \
  --header 'X-CMC_PRO_API_KEY: <api-key>'

Example Responses

{
  "data": [
    {
      "addr": "addr",
      "v24": "v24",
      "pubAt": "pubAt",
      "t0": {
        "addr": "addr",
        "lg": "lg",
        "n": "n",
        "sym": "sym",
        "liq": "liq",
        "liqUsd": "liqUsd"
      },
      "t1": {
        "addr": "addr",
        "lg": "lg",
        "n": "n",
        "sym": "sym",
        "liq": "liq",
        "liqUsd": "liqUsd"
      },
      "bidx": 0,
      "exid": 0,
      "exn": "exn",
      "liqUsd": "liqUsd",
      "fa": "fa",
      "lr": "lr",
      "br": "br",
      "top": true,
      "mi": true
    }
  ],
  "status": {
    "timestamp": "2026-03-05T22:43:48.471Z",
    "error_code": 0,
    "error_message": "",
    "elapsed": 10,
    "credit_count": 1,
    "notice": "",
    "total_count": 8128
  }
}

json

application/json

Query token liquidity

GET

https://pro-api.coinmarketcap.com

/v1/dex/token-liquidity/query

X-CMC_PRO_API_KEY (header)

Get liquidity information for a specific token

Available with no API key

Call this endpoint keyless - no API key, no signup. Prefix the path with /public-api: https://pro-api.coinmarketcap.com/public-api/v1/dex/token-liquidity/query. See the Keyless Public API for the full list, rate limits, and examples.

Query token liquidity › query Parameters

platform

string

Platform name

address

string

Token address

interval

string

Time interval

limit

integer · int32

Result limit

to

integer · int64

End timestamp

needLatest

boolean

Whether to include latest value

Query token liquidity › Headers

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Query token liquidity › Responses

200

V1_DEX_Token_Liquidity_Query_-_Response_Model

TokenLiquiditySnapshotDTO[] · required

API_Status_Object

Standardized status object for API calls.

Get swap list

GET

https://pro-api.coinmarketcap.com

/v1/dex/tokens/transactions

X-CMC_PRO_API_KEY (header)

Get swap/trade history for a token

Available with no API key

Call this endpoint keyless - no API key, no signup. Prefix the path with /public-api: https://pro-api.coinmarketcap.com/public-api/v1/dex/tokens/transactions. See the Keyless Public API for the full list, rate limits, and examples.

Get swap list › query Parameters

platform

string

Blockchain platform name (bsc/sol/etc)

address

string

Token contract address

type

integer · int32

Transaction type (0 for buy, 1 for sell)

types

string[] · explode: true

Transaction types filter, supports: buy, sell, open, close, add, reduce

maker

string

Maker address, support comma separated list

sortBy

string

Field to sort by (currently only supports 'time')

sortType

string

Sort direction ('asc' or 'desc', default is 'desc')

startTime

integer · int64

Start timestamp (inclusive)

endTime

integer · int64

End timestamp (inclusive)

minVolume

number

Minimum volume (inclusive)

maxVolume

number

Maximum volume (inclusive)

lastId

string

Cursor for pagination, format: ts_txHash_logId

limit

integer · int32

Result limit

version

string

Version

Get swap list › Headers

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Get swap list › Responses

200

V1_DEX_Tokens_Transactions_-_Response_Model

SwapListResponseDTO · required

Swap list response data

API_Status_Object

Standardized status object for API calls.

GET/v1/dex/tokens/transactions

curl https://pro-api.coinmarketcap.com/v1/dex/tokens/transactions \
  --header 'X-CMC_PRO_API_KEY: <api-key>'

Example Responses

{
  "data": {
    "swaps": [
      {
        "ts": "ts",
        "tp": "tp",
        "t0a": "t0a",
        "t1a": "t1a",
        "t0s": "t0s",
        "t1s": "t1s",
        "eid": 0,
        "en": "en",
        "f": "f",
        "a0": 0,
        "a1": 0,
        "t0pu": 0,
        "t1pu": 0,
        "q": 0,
        "v": 0,
        "qi": 0,
        "ma": "ma",
        "ex": true,
        "txtp": 0,
        "tx": "tx",
        "h": "h",
        "txId": "txId",
        "lgid": "lgid",
        "t0t": true,
        "t1t": true,
        "tags": [
          {
            "name": "name",
            "value": 0
          }
        ],
        "tc": "tc",
        "kn": "kn",
        "kpn": "kpn",
        "klu": "klu",
        "t0pt": "t0pt",
        "t1pt": "t1pt"
      }
    ],
    "lastId": "lastId"
  },
  "status": {
    "timestamp": "2026-03-05T22:43:48.471Z",
    "error_code": 0,
    "error_message": "",
    "elapsed": 10,
    "credit_count": 1,
    "notice": "",
    "total_count": 8128
  }
}

json

application/json

Get security detail

GET

https://pro-api.coinmarketcap.com

/v1/dex/security/detail

X-CMC_PRO_API_KEY (header)

Get security audit information for a token

Available with no API key

Call this endpoint keyless - no API key, no signup. Prefix the path with /public-api: https://pro-api.coinmarketcap.com/public-api/v1/dex/security/detail. See the Keyless Public API for the full list, rate limits, and examples.

Get security detail › query Parameters

platformName

string

Platform name

address

string

Token address

Get security detail › Headers

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Get security detail › Responses

200

V1_DEX_Security_Detail_-_Response_Model

TokenSecurityResponseDTO[] · required

API_Status_Object

Standardized status object for API calls.

GET/v1/dex/security/detail

curl https://pro-api.coinmarketcap.com/v1/dex/security/detail \
  --header 'X-CMC_PRO_API_KEY: <api-key>'

Example Responses

{
  "data": [
    {
      "platformName": "ethereum",
      "platformId": 1,
      "tokenContractAddress": "0xabc123...",
      "securityLevel": "securityLevel",
      "categoryLevel": "categoryLevel",
      "securityBatchLevel": 0,
      "extra": {
        "buyTax": "buyTax",
        "sellTax": "sellTax",
        "isFlaggedByVendor": false,
        "isVerified": true,
        "isReported": false,
        "source": "GoPlus"
      },
      "securityItems": [
        {
          "code": "code",
          "riskCode": "riskCode",
          "riskyLevel": "riskyLevel",
          "isHit": true,
          "order": 0,
          "des": "des",
          "groupId": "groupId"
        }
      ],
      "evmDisplay": {
        "honeypotStatus": "Safe",
        "unverifiedContractStatus": "Verified",
        "mintableStatus": "Non-mintable",
        "freezableStatus": "Non-freezable",
        "rugPullStatus": "No risk",
        "fakeTokenStatus": "Genuine"
      },
      "solanaDisplay": {
        "honeypotStatus": "Safe",
        "unverifiedContractStatus": "Verified",
        "mintableStatus": "Non-mintable",
        "freezableStatus": "Non-freezable",
        "rugPullStatus": "No risk",
        "fakeTokenStatus": "Genuine"
      },
      "exist": true,
      "tags": [
        "string"
      ]
    }
  ],
  "status": {
    "timestamp": "2026-03-05T22:43:48.471Z",
    "error_code": 0,
    "error_message": "",
    "elapsed": 10,
    "credit_count": 1,
    "notice": "",
    "total_count": 8128
  }
}

json

application/json

Search tokens

GET

https://pro-api.coinmarketcap.com

/v1/dex/search

X-CMC_PRO_API_KEY (header)

Search for tokens by keyword

Available with no API key

Call this endpoint keyless - no API key, no signup. Prefix the path with /public-api: https://pro-api.coinmarketcap.com/public-api/v1/dex/search. See the Keyless Public API for the full list, rate limits, and examples.

Search tokens › query Parameters

q

string

Search keyword

platform

string

Platform filter

sort

string

Sort field

limit

integer · int32

Result limit

code

string

Code filter

Search tokens › Headers

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Search tokens › Responses

200

V1_DEX_Search_-_Response_Model

SearchResponseDTO · required

API_Status_Object

Standardized status object for API calls.

GET/v1/dex/search

curl https://pro-api.coinmarketcap.com/v1/dex/search \
  --header 'X-CMC_PRO_API_KEY: <api-key>'

Example Responses

{
  "data": {
    "total": 0,
    "tks": [
      {
        "pltId": 0,
        "plt": "plt",
        "plti": 0,
        "n": "n",
        "s": "s",
        "addr": "addr",
        "pt": "pt",
        "lt": "lt",
        "w": "w",
        "x": "x",
        "l": "l",
        "pu": "pu",
        "pc24h": 0,
        "dec": 0,
        "tsup": "tsup",
        "fpt": "fpt",
        "fpct": "fpct",
        "v24h": 0,
        "fdv": 0,
        "mc": 0,
        "liq": 0,
        "ts": "ts",
        "lf": 0,
        "cid": 0,
        "bnCid": "bnCid",
        "ut24h": "ut24h",
        "ecs": 0,
        "ssc": 0,
        "pin": "pin"
      }
    ]
  },
  "status": {
    "timestamp": "2026-03-05T22:43:48.471Z",
    "error_code": 0,
    "error_message": "",
    "elapsed": 10,
    "credit_count": 1,
    "notice": "",
    "total_count": 8128
  }
}

json

application/json

Get liquidity change list

GET

https://pro-api.coinmarketcap.com

/v1/dex/liquidity-change/list

X-CMC_PRO_API_KEY (header)

Get liquidity change history for a token

Available with no API key

Call this endpoint keyless - no API key, no signup. Prefix the path with /public-api: https://pro-api.coinmarketcap.com/public-api/v1/dex/liquidity-change/list. See the Keyless Public API for the full list, rate limits, and examples.

Get liquidity change list › query Parameters

platform

string

Blockchain platform name (bsc/sol/etc)

address

string

Token contract address

type

integer · int32

Liquidity change type

maker

string

Maker address, support comma separated list

sortBy

string

Field to sort by (currently only supports 'ts')

sortType

string

Sort direction ('asc' or 'desc', default is 'desc')

startTime

integer · int64

Start timestamp (inclusive)

endTime

integer · int64

End timestamp (inclusive)

minVolume

number

Minimum USD volume (inclusive)

maxVolume

number

Maximum USD volume (inclusive)

lastId

string

Cursor for pagination, format: ts_txHash_logId

limit

integer · int32

Result limit

Get liquidity change list › Headers

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Get liquidity change list › Responses

200

V1_DEX_Liquidity_Change_List_-_Response_Model

LiquidityChangeListResponseDTO · required

Swap list response data

API_Status_Object

Standardized status object for API calls.

GET/v1/dex/liquidity-change/list

curl https://pro-api.coinmarketcap.com/v1/dex/liquidity-change/list \
  --header 'X-CMC_PRO_API_KEY: <api-key>'

Example Responses

{
  "data": {
    "lastId": "lastId",
    "lcs": [
      {
        "ts": "ts",
        "tp": "tp",
        "eid": 0,
        "en": "en",
        "f": "f",
        "t0a": "t0a",
        "t1a": "t1a",
        "t0s": "t0s",
        "t1s": "t1s",
        "a0": 0,
        "a1": 0,
        "tu": 0,
        "m": "m",
        "txn": "txn",
        "h": "h",
        "txId": "txId",
        "lgid": "lgid"
      }
    ],
    "tlu": 0,
    "lpc": "lpc"
  },
  "status": {
    "timestamp": "2026-03-05T22:43:48.471Z",
    "error_code": 0,
    "error_message": "",
    "elapsed": 10,
    "credit_count": 1,
    "notice": "",
    "total_count": 8128
  }
}

json

application/json

Crypto Others Platform

Token

This category includes 16 endpoints:

Get trending tokens

Get trending tokens › Headers

Get trending tokens › Request Body

Get trending tokens › Responses

Batch query tokens

Batch query tokens › Headers

Batch query tokens › Request Body

Batch query tokens › Responses

Batch get token prices

Batch get token prices › Headers

Batch get token prices › Request Body

Batch get token prices › Responses

Get new tokens

Get new tokens › Headers

Get new tokens › Request Body

Get new tokens › Responses

Get meme tokens

Get meme tokens › Headers

Get meme tokens › Request Body

Get meme tokens › Responses

Get top gainers and losers

Get top gainers and losers › Headers

Get top gainers and losers › Request Body

Get top gainers and losers › Responses

Pairs Listings Latest

Pairs Listings Latest › query Parameters

Pairs Listings Latest › Headers

Pairs Listings Latest › Responses

Quotes Latest

Quotes Latest › query Parameters

Quotes Latest › Headers

Quotes Latest › Responses

Get token detail

Get token detail › query Parameters

Get token detail › Headers

Get token detail › Responses

Get token price

Get token price › query Parameters

Get token price › Headers

Get token price › Responses

Get token pools

Get token pools › query Parameters

Get token pools › Headers

Get token pools › Responses

Query token liquidity

Query token liquidity › query Parameters

Query token liquidity › Headers

Query token liquidity › Responses

Get swap list

Get swap list › query Parameters

Get swap list › Headers

Get swap list › Responses

Get security detail

Get security detail › query Parameters

Get security detail › Headers

Get security detail › Responses

Search tokens

Search tokens › query Parameters

Search tokens › Headers

Search tokens › Responses

Get liquidity change list

Get liquidity change list › query Parameters

Get liquidity change list › Headers

Get liquidity change list › Responses