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

TrendingTokensResponseDTO

total

integer · int32

Total number of tokens

currentPage

integer · int32

Current page index

pageSize

integer · int32

Number of tokens per page

nextPageIndex

string

Next page index

version

string

Version

TokenLeaderboardDTO[]

Token Leaderboard List

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

{
  "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": 0,
      "lchAt": 0,
      "fdv": "fdv",
      "mcap": "mcap",
      "liqUsd": "liqUsd",
      "liq": "liq",
      "hld": 0,
      "p": "p",
      "np": "np",
      "pt": 0,
      "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"
      ]
    }
  ]
}

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

TokenDetailDTO[]

Detailed token information

TokenDetailDTO

n

string

Token name

sym

string

Token symbol

addr

string

Token address

plt

string

Platform name

pdex

string

Token platform dexer name (pdex)

pcid

integer · int32

Token platform crypto ID (pcid)

pid

integer · int32

Platform ID

dec

integer · int32

Token decimals

crt

string

Token creator address

own

string

Token owner address

rnc

string

Renounced address

web

string

Project website

tw

string

Twitter URL

tg

string

Telegram URL

lg

string

Logo URL

pubAt

integer · int64

Token publish timestamp

lchAt

integer · int64

Token launched timestamp

fdv

string

Fully Diluted Valuation

mcap

string

Market capitalization

ts

string

Total token supply

bs

string

Burned supply

cs

string

Circulating supply

liqUsd

string

Liquidity (USD)

liq

string

Liquidity (native)

hld

integer · int64

Holder count

p

string

Token price in USD

ph24h

string

24h price high

pl24h

string

24h price low

pt

integer · int64

Price last updated timestamp

fpt

integer · int64

Timestamp of the first time this token had a price

fpct

integer · int64

Timestamp when the first pool for this token was created

bcr

number · double

Bonding curve ratio

TokenStatsDTO[]

Token statistics

TokenTopPoolDTO[]

Top liquidity pools

turl

string

DEX trading URL

nps

integer · int64

Number of top pools

tsrc

string

Pool source

rl

string

Token risk level

lf

integer · int32

Listed flag (1 = listed, 0 = unlisted)

cid

integer · int32

Crypto currency ID

lmc

string

Listing market capitalization

lsmc

string

Listing self-reported market capitalization

lsrcs

string

Listing self-reported circulating supply

ltcs

string

Listing circulating supply

ltda

integer · int64

Listing token date added

CryptoCurrencyExchangeDTO[]

Centralized exchange listings

DexTokenSignalDTO

Token signal

ecs

integer · int32

Binance exclusive code, 1 - exclusive

la

integer · int32

show listed alert, 1-show,0-hide

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

[
  {
    "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": 0,
    "lchAt": 0,
    "fdv": "fdv",
    "mcap": "mcap",
    "ts": "ts",
    "bs": "bs",
    "cs": "cs",
    "liqUsd": "liqUsd",
    "liq": "liq",
    "hld": 0,
    "p": "p",
    "ph24h": "ph24h",
    "pl24h": "pl24h",
    "pt": 0,
    "fpt": 0,
    "fpct": 0,
    "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": 0,
        "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": 0,
    "tsrc": "tsrc",
    "rl": "rl",
    "lf": 0,
    "cid": 0,
    "lmc": "lmc",
    "lsmc": "lsmc",
    "lsrcs": "lsrcs",
    "ltcs": "ltcs",
    "ltda": 0,
    "cexs": [
      {
        "id": 0,
        "slug": "slug",
        "n": "n",
        "lg": "lg",
        "wst": "wst",
        "cat": [
          "string"
        ]
      }
    ],
    "sig": {
      "mtp": 0,
      "psc": 0
    },
    "ecs": 0,
    "la": 0
  }
]

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

TokenPriceDTO[]

Token price information

TokenPriceDTO

pid

integer · int32

Platform ID

pdex

string

Platform dexer name

pcid

integer · int32

Platform crypto ID

a

string

Token address

n

string

Token name

sym

string

Token symbol

lg

string

Logo URL

p

number

Current price (USD)

pc1h

number

Price change in last 1 hour (percentage)

pc24h

number

Price change in last 24 hours (percentage)

pc7d

number

Price change in last 7 days (percentage)

v24h

number

24-hour trading volume (USD)

l

number

Liquidity (USD)

ts

integer · int64

Timestamp of price data

mc

number

Market cap

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

NewTokenLeaderboard response object

NewTokenLeaderBoardResponseDTO

TokenLeaderboardDTO[]

List of token leaderboard entries

total

integer · int64

Total number of entries matching the filter

hasNextPage

boolean

Whether there is another page after this one

lastUpdateTime

integer · int64

Timestamp (in milliseconds) of the last update

nextPageIndex

string

Index to be used for the next page request, if hasNextPage is true

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

{
  "leaderboardList": [
    {
      "n": "n",
      "sym": "sym",
      "addr": "addr",
      "plt": "plt",
      "pid": 0,
      "pdex": "pdex",
      "pcid": 0,
      "web": "web",
      "tw": "tw",
      "tg": "tg",
      "lg": "lg",
      "pubAt": 0,
      "lchAt": 0,
      "fdv": "fdv",
      "mcap": "mcap",
      "liqUsd": "liqUsd",
      "liq": "liq",
      "hld": 0,
      "p": "p",
      "np": "np",
      "pt": 0,
      "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": 0,
  "hasNextPage": true,
  "lastUpdateTime": 0,
  "nextPageIndex": "nextPageIndex"
}

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

Response object containing categorized meme coin results

MemeCoinResponseDTO

MemeCoinResultDTO

List of meme coins that have graduated

MemeCoinResultDTO

List of meme coins that have graduated

MemeCoinResultDTO

List of meme coins that have graduated

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

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

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

Response object for the Gainer Leaderboard API

GainerLeaderBoardResponseDTO

TokenLeaderboardDTO[]

List of token leaderboard entries

pageNum

integer · int32

Current page number

pageSize

integer · int32

Number of entries per page

total

integer · int64

Total number of matching entries

hasNextPage

boolean

Whether there is another page after the current one

lastUpdateTime

integer · int64

Timestamp (in milliseconds) when the data was last updated

nextPageIndex

string

Cursor to be used for fetching the next page

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

{
  "leaderboardList": [
    {
      "n": "n",
      "sym": "sym",
      "addr": "addr",
      "plt": "plt",
      "pid": 0,
      "pdex": "pdex",
      "pcid": 0,
      "web": "web",
      "tw": "tw",
      "tg": "tg",
      "lg": "lg",
      "pubAt": 0,
      "lchAt": 0,
      "fdv": "fdv",
      "mcap": "mcap",
      "liqUsd": "liqUsd",
      "liq": "liq",
      "hld": 0,
      "p": "p",
      "np": "np",
      "pt": 0,
      "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": 0,
  "hasNextPage": true,
  "lastUpdateTime": 0,
  "nextPageIndex": "nextPageIndex"
}

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

DexSpotPairDTO[]

DexSpotPairDTO

DexQuoteDTO[]

A map of market quotes in different currency conversions. The default map included is USD.

contract_address

string

The unique contract address for this spot pair.

name

string

The name of this spot pair.

base_asset_id

string

The id of this base asset in the spot pair.

base_asset_ucid

string

The ucid of this base asset in the spot pair.

base_asset_name

string

The name of this base asset in the spot pair.

base_asset_symbol

string

The symbol of this base asset in the spot pair.

base_asset_contract_address

string

The contract addres of this base asset in the spot pair.

quote_asset_id

string

The id of this quote asset in the spot pair.

quote_asset_ucid

string

The ucid of this quote asset in the spot pair.

quote_asset_name

string

The name of this quote asset in the spot pair.

quote_asset_symbol

string

The symbol of this quote asset in the spot pair.

quote_asset_contract_address

string

The contract addresss of this quote asset in the spot pair.

dex_id

string

The id of this dex the spot pair is on.

dex_slug

string

The name of this dex the spot pair is on.

network_id

string

The id of the network the spot pair is on.

network_slug

string

The slug of the network the spot pair is on.

last_updated

string · date-time

Timestamp (ISO 8601) of the last time this record was updated.

created_at

string · date-time

Timestamp (ISO 8601) when we started tracking this asset.

num_transactions_24h

integer · int64

Number of transactions in past 24 hours

holders

integer · int64

Number of holders of the asset

24h_no_of_buys

integer · int64

Number of asset buys in the past 24 hours

24h_no_of_sells

integer · int64

Number of asset sells in the past 24 hours

pool_created

string · date-time

When the pool of the asset was created

buy_tax

number · bigdecimal

Buy tax on the asset

sell_tax

number · bigdecimal

Sell tax on the asset

SecurityScanResult[]

Security scan by Go+.

All infomation and data relating to contract detection are based on public third party information. CoinMarketCap does not confirm or verify the accuracy or timeliness of such information and data.

CoinMarketCap shall have no responsibility or liability for the accuracy of data, nor have the duty to review, confirm, verify or otherwise perform any inquiry or investigation as to the completeness, accuracy, sufficiency, integrity, reliability or timeliness of any such information or data provided.

Only returned if passed in aux.

pool_base_asset

number · bigdecimal

Base asset in the pool

pool_quote_asset

number · bigdecimal

Quote asset in the pool

percent_pooled_base_asset

number · bigdecimal

Percentage of the base asset in the pool

24h_volume_quote_asset

number · bigdecimal

24 hours volume of the quote asset

total_supply_quote_asset

number · bigdecimal

Total supply of the quote asset

total_supply_base_asset

number · bigdecimal

Total supply of the quote asset

date_launched

string · date-time

Timestamp (ISO 8601) of the launch date for this exchange.

scroll_id

string

A unique identifier used to fetch the next batch of results from the next API related API call, if applicable. scroll_id is an alternative to traditional pagingation techniques.

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

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

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

DexParisQuotesDTO[]

DEX pairs quotes data

DexParisQuotesDTO

DexQuoteDTO[]

A map of market quotes in different currency conversions. The default map included is USD.

contract_address

string

The unique contract address for this spot pair.

name

string

The name of this spot pair.

base_asset_id

string

The id of this base asset in the spot pair.

base_asset_ucid

string

The ucid of this base asset in the spot pair.

base_asset_name

string

The name of this base asset in the spot pair.

base_asset_symbol

string

The symbol of this base asset in the spot pair.

base_asset_contract_address

string

The contract addres of this base asset in the spot pair.

quote_asset_id

string

The id of this quote asset in the spot pair.

quote_asset_ucid

string

The ucid of this quote asset in the spot pair.

quote_asset_name

string

The name of this quote asset in the spot pair.

quote_asset_symbol

string

The symbol of this quote asset in the spot pair.

quote_asset_contract_address

string

The contract addresss of this quote asset in the spot pair.

dex_id

string

The id of this dex the spot pair is on.

dex_slug

string

The name of this dex the spot pair is on.

network_id

string

The id of the network the spot pair is on.

network_slug

string

The slug of the network the spot pair is on.

last_updated

string · date-time

Timestamp (ISO 8601) of the last time this record was updated.

created_at

string · date-time

Timestamp (ISO 8601) when we started tracking this asset.

num_transactions_24h

integer · int64

Number of transactions in past 24 hours

holders

integer · int64

Number of holders of the asset

24h_no_of_buys

integer · int64

Number of asset buys in the past 24 hours

24h_no_of_sells

integer · int64

Number of asset sells in the past 24 hours

pool_created

string · date-time

When the pool of the asset was created

buy_tax

number · bigdecimal

Buy tax on the asset

sell_tax

number · bigdecimal

Sell tax on the asset

SecurityScanResult[]

Security scan by Go+.

All infomation and data relating to contract detection are based on public third party information. CoinMarketCap does not confirm or verify the accuracy or timeliness of such information and data.

Only returned if passed in aux.

pool_base_asset

number · bigdecimal

Base asset in the pool

pool_quote_asset

number · bigdecimal

Quote asset in the pool

percent_pooled_base_asset

number · bigdecimal

Percentage of the base asset in the pool

24h_volume_quote_asset

number · bigdecimal

24 hours volume of the quote asset

total_supply_quote_asset

number · bigdecimal

Total supply of the quote asset

total_supply_base_asset

number · bigdecimal

Total supply of the quote asset

date_launched

string · date-time

Timestamp (ISO 8601) of the launch date for this exchange.

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

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

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

Detailed token information

TokenDetailDTO

n

string

Token name

sym

string

Token symbol

addr

string

Token address

plt

string

Platform name

pdex

string

Token platform dexer name (pdex)

pcid

integer · int32

Token platform crypto ID (pcid)

pid

integer · int32

Platform ID

dec

integer · int32

Token decimals

crt

string

Token creator address

own

string

Token owner address

rnc

string

Renounced address

web

string

Project website

tw

string

Twitter URL

tg

string

Telegram URL

lg

string

Logo URL

pubAt

integer · int64

Token publish timestamp

lchAt

integer · int64

Token launched timestamp

fdv

string

Fully Diluted Valuation

mcap

string

Market capitalization

ts

string

Total token supply

bs

string

Burned supply

cs

string

Circulating supply

liqUsd

string

Liquidity (USD)

liq

string

Liquidity (native)

hld

integer · int64

Holder count

p

string

Token price in USD

ph24h

string

24h price high

pl24h

string

24h price low

pt

integer · int64

Price last updated timestamp

fpt

integer · int64

Timestamp of the first time this token had a price

fpct

integer · int64

Timestamp when the first pool for this token was created

bcr

number · double

Bonding curve ratio

TokenStatsDTO[]

Token statistics

TokenTopPoolDTO[]

Top liquidity pools

turl

string

DEX trading URL

nps

integer · int64

Number of top pools

tsrc

string

Pool source

rl

string

Token risk level

lf

integer · int32

Listed flag (1 = listed, 0 = unlisted)

cid

integer · int32

Crypto currency ID

lmc

string

Listing market capitalization

lsmc

string

Listing self-reported market capitalization

lsrcs

string

Listing self-reported circulating supply

ltcs

string

Listing circulating supply

ltda

integer · int64

Listing token date added

CryptoCurrencyExchangeDTO[]

Centralized exchange listings

DexTokenSignalDTO

Token signal

ecs

integer · int32

Binance exclusive code, 1 - exclusive

la

integer · int32

show listed alert, 1-show,0-hide

GET/v1/dex/token

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

Example Responses

{
  "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": 0,
  "lchAt": 0,
  "fdv": "fdv",
  "mcap": "mcap",
  "ts": "ts",
  "bs": "bs",
  "cs": "cs",
  "liqUsd": "liqUsd",
  "liq": "liq",
  "hld": 0,
  "p": "p",
  "ph24h": "ph24h",
  "pl24h": "pl24h",
  "pt": 0,
  "fpt": 0,
  "fpct": 0,
  "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": 0,
      "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": 0,
  "tsrc": "tsrc",
  "rl": "rl",
  "lf": 0,
  "cid": 0,
  "lmc": "lmc",
  "lsmc": "lsmc",
  "lsrcs": "lsrcs",
  "ltcs": "ltcs",
  "ltda": 0,
  "cexs": [
    {
      "id": 0,
      "slug": "slug",
      "n": "n",
      "lg": "lg",
      "wst": "wst",
      "cat": [
        "string"
      ]
    }
  ],
  "sig": {
    "mtp": 0,
    "psc": 0
  },
  "ecs": 0,
  "la": 0
}

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

Token price information

TokenPriceDTO

pid

integer · int32

Platform ID

pdex

string

Platform dexer name

pcid

integer · int32

Platform crypto ID

a

string

Token address

n

string

Token name

sym

string

Token symbol

lg

string

Logo URL

p

number

Current price (USD)

pc1h

number

Price change in last 1 hour (percentage)

pc24h

number

Price change in last 24 hours (percentage)

pc7d

number

Price change in last 7 days (percentage)

v24h

number

24-hour trading volume (USD)

l

number

Liquidity (USD)

ts

integer · int64

Timestamp of price data

mc

number

Market cap

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

TokenTopPoolDTO[]

Token's top pool information

TokenTopPoolDTO

addr

string

Pool address

v24

string

24-hour trading volume

pubAt

integer · int64

Publish timestamp

Token

Basic token info in the pool

Token

Basic token info in the pool

bidx

integer · int32

Index of the base token in the pool (0 or 1)

exid

integer · int32

Exchange ID

exn

string

Exchange name

liqUsd

string

Liquidity in USD

fa

string

Factory address

lr

string

Locked rate

br

string

Burned rate

top

boolean

Is top pool

mi

boolean

Is meme inner pool

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

TokenLiquiditySnapshotDTO[]

TokenLiquiditySnapshotDTO

snapshotTime

integer · int64

liquidityUsd

number

liquidity

number

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

Swap list response data

SwapListResponseDTO

TradeHistoryDTO[]

List of swap transactions

lastId

string

Last ID for pagination

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

{
  "swaps": [
    {
      "ts": 0,
      "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": 0,
      "txId": 0,
      "lgid": 0,
      "t0t": true,
      "t1t": true,
      "tags": [
        {
          "name": "name",
          "value": 0
        }
      ],
      "tc": 0,
      "kn": "kn",
      "kpn": "kpn",
      "klu": "klu",
      "t0pt": "t0pt",
      "t1pt": "t1pt"
    }
  ],
  "lastId": "lastId"
}

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

TokenSecurityResponseDTO[]

Token security response

TokenSecurityResponseDTO

platformName

string

Platform name

platformId

integer · int32

Platform ID

tokenContractAddress

string

Token contract address

securityLevel

string

Overall security level

categoryLevel

string

Overall category level

securityBatchLevel

integer · int32

Overall security batch level

BnSecurityExtraInfoDTO

Extra security metadata provided by external vendors or on-chain analysis

SecurityItem[]

Detailed security items

DisplayItem

Security item display flags for EVM or Solana

DisplayItem

Security item display flags for EVM or Solana

exist

boolean

token security exist

tags

string[]

token security exist

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

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

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

SearchResponseDTO

total

integer · int32

SearchResultDTO[]

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

Swap list response data

LiquidityChangeListResponseDTO

lastId

string

Last ID for pagination

LiquidityChangeDTO[]

List of liquidity change transactions

tlu

number

total liquidity usd value

lpc

integer · int64

liquidity pool count

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