CoinMarketCap Cryptocurrency API Documentation

Token

Endpointhttps://pro-api.coinmarketcap.com

The Dex Data API has been upgraded to deliver comprehensive multi-market dex trading and on-chain data, including token information, transaction data, security metrics, K-line (candlestick) data, related pool information, and featured ranking data.

It covers data from hundreds of DEXs across multiple blockchain ecosystems such as Ethereum, Solana, and BNB Chain (BSC), with standardized data parsing and processing.

Developers can leverage this unified API to access both real-time and historical data for use cases including strategy backtesting, market monitoring, and analytics.

This category currently includes 20 endpoint:

/v4/dex/spot-pairs/latest
- Cache / Update frequency: Every 30 seconds.
  Plan credit use: 1 API call credit per request no matter query size.
  CMC equivalent pages: No equivalent, this data is only available via API.
/v4/dex/pairs/quotes/latest
- Cache / Update frequency: Every 30 seconds.
  Plan credit use: 1 API call credit per request no matter query size.
  CMC equivalent pages: No equivalent, this data is only available via API.
/v1/k-line/points
- Cache / Update frequency: Every 15 seconds.
  Plan credit use: 1 call credit per 100 k-line data points returned (rounded up)
  CMC equivalent pages: No equivalent, this data is only available via API.
/v1/k-line/candles
- Cache / Update frequency: Every 15 seconds.
  Plan credit use: 1 call credit per 100 k-line candles returned (rounded up)
  CMC equivalent pages: No equivalent, this data is only available via API.
/v1/dex/tokens/trending/list
- Cache / Update frequency: Every 30 seconds.
  Plan credit use: 1 API call credit per request.
  CMC equivalent pages: https://dex.coinmarketcap.com/token/all/?tableRankBy=trending_24h
/v1/dex/tokens/batch-query
- Cache / Update frequency: Every 10 seconds.
  Plan credit use: 1 call credit per 100 tokens returned (rounded up)
  CMC equivalent pages: No equivalent, this data is only available via API.
/v1/dex/token/price/batch
- Cache / Update frequency: Every 10 seconds.
  Plan credit use: 1 call credit per 100 tokens returned (rounded up)
  CMC equivalent pages: No equivalent, this data is only available via API.
/v1/dex/new/list
- Cache / Update frequency: Every 10 seconds.
  Plan credit use: 1 API call credit per request.
  CMC equivalent pages: https://dex.coinmarketcap.com/token/all/?tableRankBy=new_24h
/v1/dex/meme/list
- Cache / Update frequency: Every 1 minute
  Plan credit use: 1 API call credit per request.
  CMC equivalent pages: https://dex.coinmarketcap.com/meme/four.meme
/v1/dex/gainer-loser/list
- Cache / Update frequency: Every 1 minute.
  Plan credit use: 1 API call credit per request.
  CMC equivalent pages: https://dex.coinmarketcap.com/token/all/?tableRankBy=gainers_24h
/v1/dex/token
- Cache / Update frequency: Every 10 seconds.
  Plan credit use: 1 API call credit per request.
  CMC equivalent pages: No equivalent, this data is only available via API.
/v1/dex/token/price
- Cache / Update frequency: Every 10 seconds.
  Plan credit use: 1 API call credit per request.
  CMC equivalent pages: No equivalent, this data is only available via API.
/v1/dex/token/pools
- Cache / Update frequency: Every 10 minutes.
  Plan credit use: 1 API call credit per request.
  CMC equivalent pages: No equivalent, this data is only available via API.
/v1/dex/token-liquidity/query
- Cache / Update frequency: Every 1 minute.
  Plan credit use: 1 call credit per 100 tokens returned (rounded up)
  CMC equivalent pages: No equivalent, this data is only available via API.
/v1/dex/tokens/transactions
- Cache / Update frequency: Every 10 seconds.
  Plan credit use: 1 call credit per 100 tokens returned (rounded up)
  CMC equivalent pages: No equivalent, this data is only available via API.
/v1/dex/security/detail
- Cache / Update frequency: Every 90 seconds.
  Plan credit use: 1 API call credit per request.
  CMC equivalent pages: Security section on token detail page like https://dex.coinmarketcap.com/token/solana/6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN/
/v1/dex/search
- Cache / Update frequency: Every 2 minutes.
  Plan credit use: 1 API call credit per request.
  CMC equivalent pages: No equivalent, this data is only available via API.
/v1/dex/platform/list
- Cache / Update frequency: Every 1 minute.
  Plan credit use: 1 API call credit per request.
  CMC equivalent pages: No equivalent, this data is only available via API.
/v1/dex/platform/detail
- Cache / Update frequency: Every 1 minute.
  Plan credit use: 1 API call credit per request.
  CMC equivalent pages: No equivalent, this data is only available via API.
/v1/dex/liquidity-change/list
- Cache / Update frequency: Every 10 seconds.
  Plan credit use: 1 call credit per 100 tokens returned (rounded up)
  CMC equivalent pages: Liquidity changes tab underneath liquidity tab on page like https://dex.coinmarketcap.com/token/solana/6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN/

POST

https://pro-api.coinmarketcap.com

/v1/dex/tokens/trending/list

Get list of trending tokens

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

Market list request

internalUse

integer · int32

convertRestriction

integer · int32

visibleFieldConfig

string[] · unique

platformIds

string

Platform IDs, comma separated

interval

string

Time interval

nextPageIndex

string

Next page cursor

pageSize

integer · int32

Page size

object

The request parameters for querying the token leaderboard

sortBy

string

Sort field

sortType

string

Sort type: asc or desc

200

No data returned

POST/v1/dex/tokens/trending/list

curl --request POST \
  --url https://pro-api.coinmarketcap.com/v1/dex/tokens/trending/list \
  --header 'Content-Type: application/json' \
  --header 'X-CMC_PRO_API_KEY: YOUR_API_KEY' \
  --data '
{
  "internalUse": 0,
  "convertRestriction": 0,
  "visibleFieldConfig": [
    "string"
  ],
  "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"
}
'

shell

Example Request Body

{
  "internalUse": 0,
  "convertRestriction": 0,
  "visibleFieldConfig": [
    "string"
  ],
  "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

No example specified for this content type

application/octet-stream

Batch query tokens

POST

https://pro-api.coinmarketcap.com

/v1/dex/tokens/batch-query

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

internalUse

integer · int32

convertRestriction

integer · int32

visibleFieldConfig

string[] · unique

platform

string

Platform name

addresses

string[]

List of token addresses

Batch query tokens › Responses

200

No data returned

Batch get token prices

POST

https://pro-api.coinmarketcap.com

/v1/dex/token/price/batch

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

internalUse

integer · int32

convertRestriction

integer · int32

visibleFieldConfig

string[] · unique

object[]

List of platform-address pairs

Batch get token prices › Responses

200

No data returned

Get new tokens

POST

https://pro-api.coinmarketcap.com

/v1/dex/new/list

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

internalUse

integer · int32

convertRestriction

integer · int32

visibleFieldConfig

string[] · unique

platformIds

string

Platform IDs, comma separated

interval

string

Time interval

nextPageIndex

string

Next page cursor

pageSize

integer · int32

Page size

object

The request parameters for querying the token leaderboard

sortBy

string

Sort field

sortType

string

Sort type: asc or desc

Get new tokens › Responses

200

No data returned

POST/v1/dex/new/list

curl --request POST \
  --url https://pro-api.coinmarketcap.com/v1/dex/new/list \
  --header 'Content-Type: application/json' \
  --header 'X-CMC_PRO_API_KEY: YOUR_API_KEY' \
  --data '
{
  "internalUse": 0,
  "convertRestriction": 0,
  "visibleFieldConfig": [
    "string"
  ],
  "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"
}
'

shell

Example Request Body

{
  "internalUse": 0,
  "convertRestriction": 0,
  "visibleFieldConfig": [
    "string"
  ],
  "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

No example specified for this content type

application/octet-stream

Get meme tokens

POST

https://pro-api.coinmarketcap.com

/v1/dex/meme/list

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

internalUse

integer · int32

convertRestriction

integer · int32

visibleFieldConfig

string[] · unique

protocol

integer · int32

Protocol code

exclusive

integer · int32

Binance exclusive flag

limit

integer · int32

Result limit

object

Filter criteria for meme coins

object

Filter criteria for meme coins

object

Filter criteria for meme coins

Get meme tokens › Responses

200

No data returned

POST/v1/dex/meme/list

curl --request POST \
  --url https://pro-api.coinmarketcap.com/v1/dex/meme/list \
  --header 'Content-Type: application/json' \
  --header 'X-CMC_PRO_API_KEY: YOUR_API_KEY' \
  --data '
{
  "internalUse": 0,
  "convertRestriction": 0,
  "visibleFieldConfig": [
    "string"
  ],
  "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
  }
}
'

shell

Example Request Body

{
  "internalUse": 0,
  "convertRestriction": 0,
  "visibleFieldConfig": [
    "string"
  ],
  "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

No example specified for this content type

application/octet-stream

Get top gainers and losers

POST

https://pro-api.coinmarketcap.com

/v1/dex/gainer-loser/list

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

internalUse

integer · int32

convertRestriction

integer · int32

visibleFieldConfig

string[] · unique

platformIds

string

Platform IDs, comma separated

interval

string

Time interval

nextPageIndex

string

Next page cursor

pageSize

integer · int32

Page size

object

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

No data returned

POST/v1/dex/gainer-loser/list

curl --request POST \
  --url https://pro-api.coinmarketcap.com/v1/dex/gainer-loser/list \
  --header 'Content-Type: application/json' \
  --header 'X-CMC_PRO_API_KEY: YOUR_API_KEY' \
  --data '
{
  "internalUse": 0,
  "convertRestriction": 0,
  "visibleFieldConfig": [
    "string"
  ],
  "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"
}
'

shell

Example Request Body

{
  "internalUse": 0,
  "convertRestriction": 0,
  "visibleFieldConfig": [
    "string"
  ],
  "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

No example specified for this content type

application/octet-stream

Pairs Listings Latest

GET

https://pro-api.coinmarketcap.com

/v4/dex/spot-pairs/latest

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.

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

No data returned

Quotes Latest

GET

https://pro-api.coinmarketcap.com

/v4/dex/pairs/quotes/latest

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.

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

No data returned

DEX Listings Latest

GET

https://pro-api.coinmarketcap.com

/v4/dex/listings/quotes

Returns a paginated list of all decentralised cryptocurrency exchanges including the latest aggregate market data for each exchange. Use the "convert" option to return market values in multiple fiat and cryptocurrency conversions in the same call.

DEX Listings Latest › query Parameters

start

string

Optionally offset the start (1-based index) of the paginated list of items to return.

Default: 1

limit

string

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

Default: 50

sort

string

Default:"volume_24h" Valid values: "name" "volume_24h" "market_share" "num_markets" What field to sort the list of exchanges by.

Default: volume_24h

sort_dir

string

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

Default: desc

type

string

Default:"all" Valid values: "all" "orderbook" "swap" "aggregator" The category for this exchange.

Default: all

aux

string

Default:"" Valid values: "date_launched" Optionally specify a comma-separated list of supplemental data fields to return.

convert_id

string

Optionally calculate market quotes in up to 30 currencies at once by passing a comma-separated list of cryptocurrency or fiat currency IDs. Each additional convert option beyond the first requires an additional call credit. A list of supported fiat options can be found in our API document. Each conversion is returned in its own "quote" object.

DEX Listings Latest › Headers

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

DEX Listings Latest › Responses

200

No data returned

DEX Metadata

GET

https://pro-api.coinmarketcap.com

/v4/dex/listings/info

Returns all static metadata for one or more decentralised exchanges. This information includes details like launch date, logo, official website URL, social links, and market fee documentation URL.

DEX Metadata › query Parameters

id

string

One or more comma-separated CoinMarketCap cryptocurrency exchange ids.

aux

string

Default:"" Valid values: "urls" "logo" "description" "date_launched" "notice" Optionally specify a comma-separated list of supplemental data fields to return.

Default:

DEX Metadata › Headers

X-CMC_PRO_API_KEY

string · required

Your CoinMarketCap Pro API key

Default: YOUR_API_KEY

DEX Metadata › Responses

200

No data returned

Get token detail

GET

https://pro-api.coinmarketcap.com

/v1/dex/token

Get detailed information for a specific token

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

No data returned

Get token price

GET

https://pro-api.coinmarketcap.com

/v1/dex/token/price

Get current price for a specific token

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

No data returned

Get token pools

GET

https://pro-api.coinmarketcap.com

/v1/dex/token/pools

Get all pools for a specific token

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

No data returned

Query token liquidity

GET

https://pro-api.coinmarketcap.com

/v1/dex/token-liquidity/query

Get liquidity information for a specific token

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

No data returned

Get swap list

GET

https://pro-api.coinmarketcap.com

/v1/dex/tokens/transactions

Get swap/trade history for a token

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

No data returned

Get security detail

GET

https://pro-api.coinmarketcap.com

/v1/dex/security/detail

Get security audit information for a token

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

No data returned

Search tokens

GET

https://pro-api.coinmarketcap.com

/v1/dex/search

Search for tokens by keyword

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

No data returned

Get liquidity change list

GET

https://pro-api.coinmarketcap.com

/v1/dex/liquidity-change/list

Get liquidity change history for a token

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

No data returned

CMC Index Platform

Token

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

DEX Listings Latest

DEX Listings Latest › query Parameters

DEX Listings Latest › Headers

DEX Listings Latest › Responses

DEX Metadata

DEX Metadata › query Parameters

DEX Metadata › Headers

DEX Metadata › 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