CoinMarketCap

App · Cryptocurrency · 17 actions

Cryptocurrency prices, market data and rankings from CoinMarketCap, with its own indices (Fear and Greed, Altcoin Season, CMC20 and CMC100), coin categories and profiles, price conversion, and prices and safety checks for tokens on decentralized exchanges. No account or API key required; a free API key is optional and gives the connection a rate limit of its own.

Actions

ActionWhat it does
Check a token's securityCheck a token contract for common scam risks before trading it: whether it can be sold (honeypot), its buy and sell tax, and what its owner can still change.
Convert an amountConvert an amount of one cryptocurrency or currency into another at the latest price (for example, 0.5 BTC in euros), or at a time within the last month.
Get a category's coinsGet one coin category's figures and the coins in it, with their market data, largest first.
Get Altcoin Season IndexRetrieve the latest Altcoin Season Index, a 0 to 100 score of how altcoins are doing against Bitcoin: above 75 suggests altcoin season, below 25 Bitcoin season.
Get CMC100 IndexRetrieve the latest CoinMarketCap 100 Index, which tracks the 100 largest cryptocurrencies: its value, 24 hour change, and each constituent coin with its weight.
Get CMC20 IndexRetrieve the latest CoinMarketCap 20 Index, which tracks 20 of the largest cryptocurrencies: its value, 24 hour change, and each constituent coin with its weight.
Get coin infoGet a coin's profile: its description, logo, website and social links, tags, launch date, and contract addresses.
Get coin pricesLook up the current price of one or more cryptocurrencies by CoinMarketCap ID, ticker symbol or slug, in the currencies you choose (US dollars unless you pick others).
Get DEX token priceGet a token's latest price on decentralized exchanges from its contract address and network.
Get Fear and Greed historyRetrieve the CMC Crypto Fear and Greed Index for each past day, as it stood at midnight UTC, most recent first.
Get Fear and Greed IndexRetrieve the latest CMC Crypto Fear and Greed Index, a 0 to 100 gauge of market sentiment, with its label (for example, Greed) and when it was last updated.
Get global market dataRetrieve global cryptocurrency market statistics: total market cap and 24 hour volume, Bitcoin and Ethereum dominance, DeFi, stablecoin and derivatives figures, and how many coins and exchanges are active.
Get market quotesRetrieve the latest market data (price, market cap, volume, supply, and percent change from 1 hour to 90 days) for coins by ticker symbol, CoinMarketCap ID or slug.
Get top cryptocurrenciesList cryptocurrencies ranked by market cap (for example, the top 100), or sorted by price, volume, name, date added or percent change.
List categoriesList CoinMarketCap's coin categories (for example, DeFi, AI or Memes) with each one's market cap, volume, change and number of coins, or only the categories a coin belongs to.
Look up coin IDsFind the CoinMarketCap ID for a ticker symbol, or list coins with their IDs.
Search DEX tokensSearch tokens traded on decentralized exchanges by name, symbol or contract address, with each one's network, price, liquidity and 24 hour change.

Check a token's security

Check a token contract for common scam risks before trading it: whether it can be sold (honeypot), its buy and sell tax, and what its owner can still change. Takes the contract address and network. A contract CoinMarketCap has not analysed has a category level of unknown, and its verdict then means nothing.

Inputs

NetworkplatformtextRequired
The token's network, by CoinMarketCap's short name for it: ethereum, solana, bsc (BNB Smart Chain) or base, for example.
Contract addressaddresstextRequired
The token's contract address on that network. "Search DEX tokens" finds it from a name or symbol.

Outputs

securityobject
CoinMarketCap's answer.
Example output
{
  "security": {
    "data": {
      "address": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
      "buy_tax": 0.0,
      "category_level": "safe",
      "checks": [
        {
          "check": "Whitelist Restrictions Not Found",
          "description": "Whitelist restrictions allow the contract to restrict users' transactions by excluding their address from the whitelist.",
          "found": false,
          "group": "CONTRACT_RISK",
          "level": "g",
          "risk": "whitelist_function"
        },
        {
          "check": "Cooling-Off Restrictions Not Found",
          "description": "Cooling-off period means that users may not be able to buy or sell the token in a certain period of time.",
          "found": false,
          "group": "CONTRACT_RISK",
          "level": "g",
          "risk": "cooldown_function"
        }
      ],
      "flagged_by_vendor": false,
      "honeypot": false,
      "network": "Ethereum",
      "network_id": 1,
      "reported": false,
      "risks_found": [],
      "security_level": "safe",
      "sell_tax": 0.0,
      "verified": true
    },
    "status": {
      "credit_count": 1,
      "elapsed": 179,
      "error_code": "0",
      "error_message": "",
      "timestamp": "2026-09-25T18:04:55.411Z"
    }
  }
}

Convert an amount

Convert an amount of one cryptocurrency or currency into another at the latest price (for example, 0.5 BTC in euros), or at a time within the last month.

Inputs

AmountamountnumberRequired
How much to convert (for example, 0.5).From 1e-08 to 1000000000000.
Symbolsymboltext
What to convert from, by symbol (for example, BTC or USD). When several coins share the symbol, the one with the largest market cap comes first. Give a symbol or a CoinMarketCap ID.
CoinMarketCap IDcoin_idtext
What to convert from, by CoinMarketCap ID (for example, 1027 for Ethereum). Give a symbol or an ID.
Convert toconverttext
The currency to convert into, as a code such as EUR, or a coin's symbol such as ETH. Defaults to USD.
At timetimedate and time
Convert at the price at this time instead of now, as a date and time in UTC. CoinMarketCap uses the closest price it has. Without an API key, only the last month is available.

Outputs

conversionobject
CoinMarketCap's answer.
Example output
{
  "conversion": {
    "data": [
      {
        "amount": 100,
        "id": 1027,
        "last_updated": "2026-09-25T17:47:00.000Z",
        "name": "Ethereum",
        "quote": {
          "USD": {
            "last_updated": "2026-09-25T17:48:02.000Z",
            "price": 268400.7763749515
          }
        },
        "symbol": "ETH"
      }
    ],
    "status": {
      "credit_count": 1,
      "elapsed": 2,
      "error_code": 0,
      "error_message": null,
      "notice": null,
      "timestamp": "2026-09-25T17:49:18.185Z"
    }
  }
}

Get a category's coins

Get one coin category's figures and the coins in it, with their market data, largest first.

Inputs

Category IDcategory_idtextRequired
The category's ID, from "List categories" (for example, 6051a82566fc1b42617d6dc6 for Memes).
Startstartnumber
The position among the category's coins to start from, counting from 1.At least 1.
Limitlimitnumber
How many of the category's coins to return, from 1 to 1000. Leave empty for 100.From 1 to 1000.
Currencyconverttext
The currency to show values in, as a code such as USD or EUR, or a coin's symbol such as BTC. Defaults to USD.

Outputs

categoryobject
CoinMarketCap's answer.
Example output
{
  "category": {
    "data": {
      "avg_price_change": 2.676063950428749,
      "coins": [
        {
          "circulating_supply": 831066783.0,
          "cmc_rank": 72,
          "date_added": "2017-12-13T00:00:00.000Z",
          "id": 2280,
          "infinite_supply": false,
          "is_active": 1,
          "is_fiat": 0,
          "last_updated": "2026-09-25T18:24:00.000Z",
          "max_supply": null,
          "minted_market_cap": 2013557769.19,
          "name": "Filecoin",
          "num_market_pairs": 723,
          "platform": null,
          "quote": {
            "USD": {
              "fully_diluted_market_cap": 2013557769.19,
              "last_updated": "2026-09-25T18:25:03.000Z",
              "market_cap": 855072059.6,
              "market_cap_dominance": 0.0296,
              "percent_change_1h": 0.47148061,
              "percent_change_24h": 3.22403405,
              "percent_change_30d": 47.21228924,
              "percent_change_60d": 42.23777964,
              "percent_change_7d": 15.69889065,
              "percent_change_90d": 39.14758533,
              "price": 1.028884894803339,
              "tvl": null,
              "volume_24h": 155809063.66566017,
              "volume_change_24h": -19.5712
            }
          },
          "self_reported_circulating_supply": 0,
          "self_reported_market_cap": 0,
          "slug": "filecoin",
          "symbol": "FIL",
          "tags": [
            "mineable",
            "ai-big-data",
            "distributed-computing"
          ],
          "total_supply": 1957029187.0,
          "tvl_ratio": null
        },
        {
          "circulating_supply": 987037885840674.8,
          "cmc_rank": 104,
          "date_added": "2019-01-31T00:00:00.000Z",
          "id": 16086,
          "infinite_supply": false,
          "is_active": 1,
          "is_fiat": 0,
          "last_updated": "2026-09-25T18:24:00.000Z",
          "max_supply": null,
          "minted_market_cap": 368484050.48,
          "name": "BitTorrent [New]",
          "num_market_pairs": 216,
          "platform": {
            "id": 1958,
            "name": "Tron20",
            "slug": "tron",
            "symbol": "TRX",
            "token_address": "TAFjULxiVgT4qWk6UZwjqwZXTSaGaqnVp4"
          },
          "quote": {
            "USD": {
              "fully_diluted_market_cap": 368484050.48,
              "last_updated": "2026-09-25T18:25:03.000Z",
              "market_cap": 368484050.48,
              "market_cap_dominance": 0.0128,
              "percent_change_1h": -0.04037288,
              "percent_change_24h": 0.90902219,
              "percent_change_30d": 30.6236433,
              "percent_change_60d": 40.37046234,
              "percent_change_7d": 12.5355906,
              "percent_change_90d": 42.17028717,
              "price": 3.733231072120151e-07,
              "tvl": null,
              "volume_24h": 10593895.76114162,
              "volume_change_24h": -20.9709
            }
          },
          "self_reported_circulating_supply": 0,
          "self_reported_market_cap": 0,
          "slug": "bittorrent-new",
          "symbol": "BTT",
          "tags": [
            "platform",
            "distributed-computing",
            "defi"
          ],
          "total_supply": 987037885840674.8,
          "tvl_ratio": null
        }
      ],
      "description": "The File-sharing category includes decentralized protocols enabling peer-to-peer file sharing and distribution over blockchain networks, providing censorship-resistant alternatives to centralized file hosting services.",
      "id": "6051a82066fc1b42617d6dc0",
      "last_updated": "2021-11-10T10:35:12.354Z",
      "market_cap": 1980728603.6227627,
      "market_cap_change": 2.032844027011,
      "name": "Filesharing",
      "num_tokens": 51,
      "title": "Filesharing",
      "volume": 239345743.05559796,
      "volume_change": -9.212085891378
    },
    "status": {
      "credit_count": 1,
      "elapsed": 13,
      "error_code": 0,
      "error_message": null,
      "notice": null,
      "timestamp": "2026-09-25T18:26:32.976Z"
    }
  }
}

Get Altcoin Season Index

Retrieve the latest Altcoin Season Index, a 0 to 100 score of how altcoins are doing against Bitcoin: above 75 suggests altcoin season, below 25 Bitcoin season. Includes its high and low over the past year.

Inputs

None.

Outputs

altcoin_seasonobject
CoinMarketCap's answer.
Example output
{
  "altcoin_season": {
    "data": {
      "altcoin_index": 59,
      "altcoin_marketcap": 1190410735498.84,
      "snapshot_time": "2026-09-25T17:40:01Z",
      "yearly_high": 70,
      "yearly_high_date": "2025-09-25",
      "yearly_low": 14,
      "yearly_low_date": "2025-12-19"
    },
    "status": {
      "credit_count": 1,
      "elapsed": 3,
      "error_code": 0,
      "error_message": null,
      "notice": null,
      "timestamp": "2026-09-25T17:48:26.172Z"
    }
  }
}

Get CMC100 Index

Retrieve the latest CoinMarketCap 100 Index, which tracks the 100 largest cryptocurrencies: its value, 24 hour change, and each constituent coin with its weight.

Inputs

None.

Outputs

indexobject
CoinMarketCap's answer.
Example output
{
  "index": {
    "data": {
      "constituents": [
        {
          "id": 1,
          "name": "Bitcoin",
          "symbol": "BTC",
          "url": "https://coinmarketcap.com/currencies/bitcoin",
          "weight": 65.75
        },
        {
          "id": 1027,
          "name": "Ethereum",
          "symbol": "ETH",
          "url": "https://coinmarketcap.com/currencies/ethereum",
          "weight": 12.81
        }
      ],
      "last_update": "2026-09-25T17:45:00.000Z",
      "next_update": "2026-09-25T17:50:00.000Z",
      "value": 168.91,
      "value_24h_percentage_change": 0.26
    },
    "status": {
      "credit_count": 1,
      "elapsed": 3,
      "error_code": "0",
      "error_message": "",
      "timestamp": "2026-09-25T17:48:52.176Z"
    }
  }
}

Get CMC20 Index

Retrieve the latest CoinMarketCap 20 Index, which tracks 20 of the largest cryptocurrencies: its value, 24 hour change, and each constituent coin with its weight.

Inputs

None.

Outputs

indexobject
CoinMarketCap's answer.
Example output
{
  "index": {
    "data": {
      "constituents": [
        {
          "id": 1,
          "name": "Bitcoin",
          "priceUsd": 83750.82998357555,
          "symbol": "BTC",
          "units": 0.00144933985088,
          "url": "https://coinmarketcap.com/currencies/bitcoin",
          "weight": 68.78
        },
        {
          "id": 1027,
          "name": "Ethereum",
          "priceUsd": 2682.706218385904,
          "symbol": "ETH",
          "units": 0.00871258201991,
          "url": "https://coinmarketcap.com/currencies/ethereum",
          "weight": 13.39
        }
      ],
      "last_update": "2026-09-25T17:48:39.000Z",
      "next_update": "2026-09-25T17:48:40.000Z",
      "value": 176.59,
      "value_24h_percentage_change": 0.05
    },
    "status": {
      "credit_count": 1,
      "elapsed": 4,
      "error_code": "0",
      "error_message": "",
      "timestamp": "2026-09-25T17:48:39.184Z"
    }
  }
}

Get coin info

Get a coin's profile: its description, logo, website and social links, tags, launch date, and contract addresses. Look coins up by CoinMarketCap ID, symbol or slug.

Inputs

CoinMarketCap IDsidstext
The coins by CoinMarketCap ID, separated by commas (for example, 1,1027 for Bitcoin and Ethereum). An ID names exactly one coin. Give IDs, symbols or slugs. Use "Look up coin IDs" to find an ID.
Symbolssymboltext
The coins by ticker symbol, separated by commas (for example, BTC,ETH). Every coin using a symbol comes back, best match first. Give IDs, symbols or slugs.
Slugsslugtext
The coins by the name in their coinmarketcap.com address, separated by commas (for example, bitcoin,solana). Give IDs, symbols or slugs.

Outputs

infoobject
CoinMarketCap's answer.
Example output
{
  "info": {
    "data": [
      {
        "category": "coin",
        "date_added": "2010-07-13T00:00:00.000Z",
        "date_launched": "2010-07-13T00:00:00.000Z",
        "description": "Bitcoin (BTC) is a cryptocurrency launched in 2010. Users are able to generate BTC through the process of mining. Bitcoin has a current supply of 20,089,259. The last known price of Bitcoin is 83,770.25880746 USD and is down -0.47 over the last 24 hours. It is currently trading on 12751 active market(s) with $36,035,359,393.30 traded over the last 24 hours. More information can be found at https://bitcoin.org/.",
        "id": 1,
        "infinite_supply": false,
        "is_hidden": 0,
        "logo": "https://s2.coinmarketcap.com/static/img/coins/64x64/1.png",
        "name": "Bitcoin",
        "notice": "",
        "platform": null,
        "slug": "bitcoin",
        "subreddit": "bitcoin",
        "symbol": "BTC",
        "tag-groups": [
          "OTHERS",
          "ALGORITHM",
          "ALGORITHM"
        ],
        "tag-names": [
          "Mineable",
          "PoW",
          "SHA-256"
        ],
        "tags": [
          "mineable",
          "pow",
          "sha-256"
        ],
        "twitter_username": "",
        "urls": {
          "announcement": [],
          "chat": [],
          "explorer": [
            "https://blockchain.info/",
            "https://live.blockcypher.com/btc/",
            "https://blockchair.com/bitcoin"
          ],
          "facebook": [],
          "message_board": [
            "https://bitcointalk.org"
          ],
          "reddit": [
            "https://reddit.com/r/bitcoin"
          ],
          "source_code": [
            "https://github.com/bitcoin/bitcoin"
          ],
          "technical_doc": [
            "https://bitcoin.org/bitcoin.pdf"
          ],
          "twitter": [],
          "website": [
            "https://bitcoin.org/"
          ]
        }
      }
    ],
    "not_found": [],
    "status": {
      "credit_count": 1,
      "elapsed": 4,
      "error_code": 0,
      "error_message": null,
      "notice": null,
      "timestamp": "2026-09-25T17:53:19.628Z"
    }
  }
}

Get coin prices

Look up the current price of one or more cryptocurrencies by CoinMarketCap ID, ticker symbol or slug, in the currencies you choose (US dollars unless you pick others). Optionally include each coin's market cap, 24 hour volume and 24 hour change.

Inputs

CoinMarketCap IDsidstext
The coins by CoinMarketCap ID, separated by commas (for example, 1,1027 for Bitcoin and Ethereum). An ID names exactly one coin. Give IDs, symbols or slugs. Use "Look up coin IDs" to find an ID.
Symbolssymboltext
The coins by ticker symbol, separated by commas (for example, BTC,ETH). A symbol several coins share is priced as the one with the largest market cap. Give IDs, symbols or slugs.
Slugsslugtext
The coins by the name in their coinmarketcap.com address, separated by commas (for example, bitcoin,solana). Give IDs, symbols or slugs.
Currenciesconverttext
The currencies to show prices in, as codes separated by commas (for example, USD or USD,EUR), or a coin's symbol such as BTC. Defaults to USD. Price is in the first one; Quote holds them all.
Include market capinclude_market_captrue/false
Set to true to add each coin's market cap.
Include 24 hour volumeinclude_24h_volumetrue/false
Set to true to add each coin's trading volume over the last 24 hours.
Include 24 hour changeinclude_24h_changetrue/false
Set to true to add how much each coin's price changed over the last 24 hours, in percent.
Include last updatedinclude_last_updatedtrue/false
Set to true to add when each price was last updated.

Outputs

pricesobject
CoinMarketCap's answer.
Example output
{
  "prices": {
    "data": [
      {
        "currency": "USD",
        "id": 1,
        "name": "Bitcoin",
        "price": 84182.38634306753,
        "quote": {
          "USD": {
            "last_updated": "2026-09-25T05:06:02.000Z",
            "market_cap": 1691141474528.838,
            "percent_change_24h": -0.10319839,
            "price": 84182.38634306753,
            "symbol": "USD",
            "volume_24h": 36699371082.03381
          }
        },
        "slug": "bitcoin",
        "symbol": "BTC"
      }
    ],
    "not_found": [],
    "status": {
      "credit_count": 1,
      "elapsed": 7,
      "error_code": "0",
      "error_message": "",
      "timestamp": "2026-09-25T05:07:45.074Z"
    }
  }
}

Get DEX token price

Get a token's latest price on decentralized exchanges from its contract address and network.

Inputs

NetworkplatformtextRequired
The token's network, by CoinMarketCap's short name for it: ethereum, solana, bsc (BNB Smart Chain) or base, for example.
Contract addressaddresstextRequired
The token's contract address on that network. "Search DEX tokens" finds it from a name or symbol.

Outputs

priceobject
CoinMarketCap's answer.
Example output
{
  "price": {
    "data": {
      "address": "0x0e09fabb73bd3ade0a17ecc321fd13a19e81ce82",
      "liquidity_usd": 19675642.996399723,
      "market_cap_usd": 14896744357.814064,
      "network": "BSC",
      "network_id": 14,
      "percent_change_24h": 0.89,
      "percent_change_7d": 11.88,
      "price_usd": 2.7649361286310925,
      "updated_at": "2026-09-25T20:22:16Z",
      "volume_24h_usd": 9128841.722671857
    },
    "status": {
      "credit_count": 1,
      "elapsed": 172,
      "error_code": "0",
      "error_message": "",
      "timestamp": "2026-09-25T20:22:28.587Z"
    }
  }
}

Get Fear and Greed history

Retrieve the CMC Crypto Fear and Greed Index for each past day, as it stood at midnight UTC, most recent first.

Inputs

Startstartnumber
How many days back to start from, counting from 1 for the most recent day.At least 1.
Dayslimitnumber
How many days to return, from 1 to 500. Leave empty for 50.From 1 to 500.

Outputs

historyobject
CoinMarketCap's answer.
Example output
{
  "history": {
    "data": [
      {
        "date": "2026-09-24",
        "timestamp": "1790208000",
        "value": 73,
        "value_classification": "Greed"
      },
      {
        "date": "2026-09-23",
        "timestamp": "1790121600",
        "value": 74,
        "value_classification": "Greed"
      }
    ],
    "status": {
      "credit_count": 1,
      "elapsed": 3,
      "error_code": "0",
      "error_message": "",
      "timestamp": "2026-09-25T17:45:16.778Z"
    }
  }
}

Get Fear and Greed Index

Retrieve the latest CMC Crypto Fear and Greed Index, a 0 to 100 gauge of market sentiment, with its label (for example, Greed) and when it was last updated.

Inputs

None.

Outputs

fear_and_greedobject
CoinMarketCap's answer.
Example output
{
  "fear_and_greed": {
    "data": {
      "update_time": "2026-09-25T17:38:10.071Z",
      "value": 72,
      "value_classification": "Greed"
    },
    "status": {
      "credit_count": 1,
      "elapsed": 2,
      "error_code": "0",
      "error_message": "",
      "timestamp": "2026-09-25T17:45:03.822Z"
    }
  }
}

Get global market data

Retrieve global cryptocurrency market statistics: total market cap and 24 hour volume, Bitcoin and Ethereum dominance, DeFi, stablecoin and derivatives figures, and how many coins and exchanges are active.

Inputs

Currencyconverttext
The currency to show values in, as a code such as USD or EUR, or a coin's symbol such as BTC. Defaults to USD.

Outputs

metricsobject
CoinMarketCap's answer.
Example output
{
  "metrics": {
    "data": {
      "active_cryptocurrencies": 8163,
      "active_exchanges": 978,
      "active_market_pairs": 114156,
      "btc_dominance": 58.553685363869,
      "btc_dominance_24h_percentage_change": -0.339274436131,
      "btc_dominance_yesterday": 58.8929598,
      "defi_24h_percentage_change": 11.249352142081,
      "defi_market_cap": 90230350200.62611,
      "defi_volume_24h": 14727938464.210121,
      "defi_volume_24h_reported": 118426738630.20804,
      "derivatives_24h_percentage_change": -6.457015420242,
      "derivatives_volume_24h": 1008416854986.0178,
      "derivatives_volume_24h_reported": 1033427004204.9628,
      "eth_dominance": 11.40837409992,
      "eth_dominance_24h_percentage_change": 0.04609284992,
      "eth_dominance_yesterday": 11.36228125,
      "last_updated": "2026-09-25T17:42:59.999Z",
      "past_24h_incremental_crypto_number": 112047,
      "past_30d_incremental_crypto_number": 3479136,
      "past_7d_incremental_crypto_number": 713343,
      "quote": {
        "USD": {
          "altcoin_market_cap": 1191818908969.912,
          "altcoin_volume_24h": 69312802278.38333,
          "altcoin_volume_24h_reported": 442483080142.1083,
          "defi_24h_percentage_change": 11.2493521421,
          "defi_market_cap": 90230350200.62611,
          "defi_volume_24h": 14727938464.210121,
          "defi_volume_24h_reported": 118426738630.20804,
          "derivatives_24h_percentage_change": -6.4570154202,
          "derivatives_volume_24h": 1008416854986.0178,
          "derivatives_volume_24h_reported": 1033427004204.9628,
          "last_updated": "2026-09-25T17:42:59.999Z",
          "stablecoin_24h_percentage_change": 4.4357879599,
          "stablecoin_market_cap": 286013602518.68,
          "stablecoin_volume_24h": 106532018101.00516,
          "stablecoin_volume_24h_reported": 626996497313.626,
          "total_market_cap": 2875572700331.1123,
          "total_market_cap_yesterday": 2871181920878.7124,
          "total_market_cap_yesterday_percentage_change": 0.15292585,
          "total_volume_24h": 104810992817.98,
          "total_volume_24h_reported": 633588043738.41,
          "total_volume_24h_yesterday": 99201294197.9,
          "total_volume_24h_yesterday_percentage_change": 5.65486435
        }
      },
      "stablecoin_24h_percentage_change": 4.435787959903,
      "stablecoin_market_cap": 286013602518.68,
      "stablecoin_volume_24h": 106532018101.00516,
      "stablecoin_volume_24h_reported": 626996497313.626,
      "today_change_percent": 0.000118008204,
      "today_incremental_crypto_number": 0,
      "total_crypto_dex_currencies": 61860179,
      "total_cryptocurrencies": 39744,
      "total_exchanges": 12976,
      "tracked_yearly_number": {
        "maxIncrementalDate": "2026-03-19T00:00:00.000Z",
        "maxIncrementalNumber": 7681147,
        "minIncrementalDate": "2026-09-25T00:00:00.000Z",
        "minIncrementalNumber": 73
      }
    },
    "status": {
      "credit_count": 1,
      "elapsed": 3,
      "error_code": 0,
      "error_message": null,
      "notice": null,
      "timestamp": "2026-09-25T17:44:50.830Z"
    }
  }
}

Get market quotes

Retrieve the latest market data (price, market cap, volume, supply, and percent change from 1 hour to 90 days) for coins by ticker symbol, CoinMarketCap ID or slug. Every coin using a symbol comes back, best match first: active coins by market cap rank, so the first result for SOL is Solana.

Inputs

Symbolssymboltext
The coins by ticker symbol, separated by commas (for example, BTC,ETH). Other coins sharing a symbol follow the best match. Give symbols, IDs or slugs.
CoinMarketCap IDsidstext
The coins by CoinMarketCap ID, separated by commas (for example, 1,1027 for Bitcoin and Ethereum). An ID names exactly one coin. Give IDs, symbols or slugs. Use "Look up coin IDs" to find an ID.
Slugsslugtext
The coins by the name in their coinmarketcap.com address, separated by commas (for example, bitcoin,solana). Give IDs, symbols or slugs.
Currencyconverttext
The currency to show values in (for example, USD or EUR). Defaults to USD. One currency at a time.

Outputs

quotesobject
CoinMarketCap's answer.
Example output
{
  "quotes": {
    "data": [
      {
        "circulating_supply": 587653363.899461,
        "cmc_rank": 7,
        "date_added": "2020-04-10T00:00:00.000Z",
        "id": 5426,
        "infinite_supply": true,
        "is_active": 1,
        "is_fiat": 0,
        "last_updated": "2026-09-25T17:29:00.000Z",
        "max_supply": null,
        "minted_market_cap": 76606077986.85,
        "name": "Solana",
        "num_market_pairs": 1181,
        "platform": null,
        "quote": {
          "USD": {
            "cex_volume_24h": 5855419857.933935,
            "dex_volume_24h": 13562902.76781095,
            "fully_diluted_market_cap": 76606077986.85,
            "id": 2781,
            "last_updated": "2026-09-25T17:29:03.000Z",
            "market_cap": 70929282165.43422,
            "market_cap_dominance": 2.4649,
            "minted_market_cap": 76606077986.85,
            "percent_change_1h": -0.4230858,
            "percent_change_24h": 3.25186272,
            "percent_change_30d": 24.68945947,
            "percent_change_60d": 58.85034181,
            "percent_change_7d": 7.76188566,
            "percent_change_90d": 67.38146671,
            "price": 120.69918513657856,
            "symbol": "USD",
            "tvl": null,
            "volume_24h": 5868982760.701746,
            "volume_change_24h": 54.0915
          }
        },
        "self_reported_circulating_supply": 525236893.3,
        "self_reported_market_cap": 63395665024.97806,
        "slug": "solana",
        "symbol": "SOL",
        "tags": [
          {
            "category": "ALGORITHM",
            "name": "PoS",
            "slug": "pos"
          },
          {
            "category": "CATEGORY",
            "name": "Platform",
            "slug": "platform"
          },
          {
            "category": "PLATFORM",
            "name": "Solana Ecosystem",
            "slug": "solana-ecosystem"
          }
        ],
        "total_supply": 634685958.3199703,
        "tvl_ratio": null
      },
      {
        "circulating_supply": 1830660.34251542,
        "cmc_rank": 8023,
        "date_added": "2021-12-16T04:30:23.000Z",
        "id": 16116,
        "infinite_supply": false,
        "is_active": 1,
        "is_fiat": 0,
        "last_updated": "2026-09-25T17:28:00.000Z",
        "max_supply": null,
        "minted_market_cap": 221522221.92,
        "name": "Wrapped Solana",
        "num_market_pairs": 14934,
        "platform": {
          "id": 5426,
          "name": "Solana",
          "slug": "solana",
          "symbol": "SOL",
          "token_address": "So11111111111111111111111111111111111111112"
        },
        "quote": {
          "USD": {
            "cex_volume_24h": 31809518.21464187,
            "dex_volume_24h": 571738342.7693177,
            "fully_diluted_market_cap": 221522221.92,
            "id": 2781,
            "last_updated": "2026-09-25T17:29:03.000Z",
            "market_cap": 221522221.91951448,
            "market_cap_dominance": 0,
            "minted_market_cap": 221522221.92,
            "percent_change_1h": 0.02661575,
            "percent_change_24h": 3.47772841,
            "percent_change_30d": 25.3207145,
            "percent_change_60d": 59.32569571,
            "percent_change_7d": 8.14890881,
            "percent_change_90d": 67.8118652,
            "price": 121.00673007158265,
            "symbol": "USD",
            "tvl": null,
            "volume_24h": 603547860.9839588,
            "volume_change_24h": 10.4761
          }
        },
        "self_reported_circulating_supply": null,
        "self_reported_market_cap": null,
        "slug": "wrapped-solana",
        "symbol": "SOL",
        "tags": [
          {
            "category": "CATEGORY",
            "name": "DeFi",
            "slug": "defi"
          },
          {
            "category": "PLATFORM",
            "name": "Ethereum Ecosystem",
            "slug": "ethereum-ecosystem"
          },
          {
            "category": "PLATFORM",
            "name": "Avalanche Ecosystem",
            "slug": "avalanche-ecosystem"
          }
        ],
        "total_supply": 1830660.34251542,
        "tvl_ratio": null
      }
    ],
    "not_found": [],
    "status": {
      "credit_count": 1,
      "elapsed": 6,
      "error_code": "0",
      "error_message": "",
      "timestamp": "2026-09-25T17:30:10.689Z"
    }
  }
}

Get top cryptocurrencies

List cryptocurrencies ranked by market cap (for example, the top 100), or sorted by price, volume, name, date added or percent change. Narrow the list to coins or tokens, to a tag such as defi, or by price, market cap, volume or 24 hour change.

Inputs

Start rankstartnumber
The position in the list to start from, counting from 1 (for example, 101 for the second hundred). Leave empty to start at 1.At least 1.
Limitlimitnumber
How many coins to return, from 1 to 5000. Leave empty for 100.From 1 to 5000.
Currencyconverttext
The currency to show values in (for example, USD or EUR). Defaults to USD. One currency at a time.
Sort bysorttext
What to order the list by. Leave empty for market cap rank. Sorting by change puts the smallest, most volatile coins first.One of: market_cap (Market cap rank), name, price, volume_24h (24 hour volume), percent_change_1h (1 hour change), percent_change_24h (24 hour change), percent_change_7d (7 day change), date_added (Date added), circulating_supply (Circulating supply).
Sort directionsort_dirtext
Highest first (the default) or lowest first.One of: desc (Highest first), asc (Lowest first).
Typecryptocurrency_typetext
Coins with a blockchain of their own, tokens that live on another blockchain, or both (the default).One of: all (Coins and tokens), coins (Coins with their own blockchain), tokens (Tokens on another blockchain).
Tagtagtext
Only coins CoinMarketCap tags as DeFi or Filesharing, the two tags this list filters by. Leave Type empty with a tag: CoinMarketCap returns nothing for a tag with coins only or tokens only.One of: all (Any tag), defi, filesharing.
Minimum price (USD)price_minnumber
Keep only coins priced at this many US dollars or more. CoinMarketCap applies it to the page of results Start rank and Limit select, so raise the limit to search more coins.
Maximum price (USD)price_maxnumber
Keep only coins priced at this many US dollars or less. CoinMarketCap applies it to the page of results Start rank and Limit select, so raise the limit to search more coins.
Minimum market cap (USD)market_cap_minnumber
Keep only coins with at least this market cap in US dollars (for example, 1000000000 for a billion). CoinMarketCap applies it to the page of results Start rank and Limit select, so raise the limit to search more coins.
Maximum market cap (USD)market_cap_maxnumber
Keep only coins with at most this market cap in US dollars. CoinMarketCap applies it to the page of results Start rank and Limit select, so raise the limit to search more coins.
Minimum 24 hour volume (USD)volume_24h_minnumber
Keep only coins that traded at least this much in the last 24 hours, in US dollars. CoinMarketCap applies it to the page of results Start rank and Limit select, so raise the limit to search more coins.
Maximum 24 hour volume (USD)volume_24h_maxnumber
Keep only coins that traded at most this much in the last 24 hours, in US dollars. CoinMarketCap applies it to the page of results Start rank and Limit select, so raise the limit to search more coins.
Minimum 24 hour change (%)percent_change_24h_minnumber
Keep only coins whose price rose by at least this percent over 24 hours (a negative number allows falls down to it). CoinMarketCap applies it to the page of results Start rank and Limit select, so raise the limit to search more coins.
Maximum 24 hour change (%)percent_change_24h_maxnumber
Keep only coins whose price changed by at most this percent over 24 hours (for example, -5 for falls of 5% or more). CoinMarketCap applies it to the page of results Start rank and Limit select, so raise the limit to search more coins.

Outputs

listingsobject
CoinMarketCap's answer.
Example output
{
  "listings": {
    "data": [
      {
        "circulating_supply": 20089259,
        "cmc_rank": 1,
        "date_added": "2010-07-13T00:00:00.000Z",
        "id": 1,
        "infinite_supply": false,
        "last_updated": "2026-09-25T17:38:00.000Z",
        "max_supply": 21000000,
        "minted_market_cap": 1681406363162.6,
        "name": "Bitcoin",
        "num_market_pairs": 12751,
        "platform": null,
        "quote": {
          "USD": {
            "cex_volume_24h": 35994293122.36931,
            "dex_volume_24h": 37932539.79499079,
            "fully_diluted_market_cap": 1757632455553.22,
            "id": 2781,
            "last_updated": "2026-09-25T17:38:00.000Z",
            "market_cap": 1681406363162.5967,
            "market_cap_dominance": 58.5387,
            "minted_market_cap": 1681406363162.6,
            "percent_change_1h": -0.28384216,
            "percent_change_24h": -0.59585159,
            "percent_change_30d": 6.5771819,
            "percent_change_60d": 28.80174349,
            "percent_change_7d": 3.76954491,
            "percent_change_90d": 38.26107691,
            "price": 83696.78359777216,
            "symbol": "USD",
            "tvl": null,
            "volume_24h": 36032225662.1643,
            "volume_change_24h": -4.0043
          }
        },
        "self_reported_circulating_supply": null,
        "self_reported_market_cap": null,
        "slug": "bitcoin",
        "symbol": "BTC",
        "tags": [
          "mineable",
          "pow",
          "sha-256"
        ],
        "total_supply": 20089259,
        "tvl_ratio": null
      },
      {
        "circulating_supply": 122078905.3531288,
        "cmc_rank": 2,
        "date_added": "2015-08-07T00:00:00.000Z",
        "id": 1027,
        "infinite_supply": true,
        "last_updated": "2026-09-25T17:38:00.000Z",
        "max_supply": null,
        "minted_market_cap": 327380210507.41,
        "name": "Ethereum",
        "num_market_pairs": 13731,
        "platform": null,
        "quote": {
          "USD": {
            "cex_volume_24h": 14313699313.051603,
            "dex_volume_24h": 366836185.41092235,
            "fully_diluted_market_cap": 327380210507.41,
            "id": 2781,
            "last_updated": "2026-09-25T17:38:00.000Z",
            "market_cap": 327380210507.4106,
            "market_cap_dominance": 11.3971,
            "minted_market_cap": 327380210507.41,
            "percent_change_1h": -0.31035898,
            "percent_change_24h": 0.22661873,
            "percent_change_30d": 8.88508893,
            "percent_change_60d": 38.11663229,
            "percent_change_7d": 3.6111843,
            "percent_change_90d": 68.32372343,
            "price": 2681.709911801892,
            "symbol": "USD",
            "tvl": null,
            "volume_24h": 14680535498.462523,
            "volume_change_24h": 9.0853
          }
        },
        "self_reported_circulating_supply": null,
        "self_reported_market_cap": null,
        "slug": "ethereum",
        "symbol": "ETH",
        "tags": [
          "pos",
          "smart-contracts",
          "ethereum-ecosystem"
        ],
        "total_supply": 122078905.3531288,
        "tvl_ratio": null
      }
    ],
    "status": {
      "credit_count": 1,
      "elapsed": 6,
      "error_code": "0",
      "error_message": "",
      "timestamp": "2026-09-25T17:39:05.448Z"
    }
  }
}

List categories

List CoinMarketCap's coin categories (for example, DeFi, AI or Memes) with each one's market cap, volume, change and number of coins, or only the categories a coin belongs to. Use a category's ID with "Get a category's coins".

Inputs

Startstartnumber
The position in the list to start from, counting from 1.At least 1.
Limitlimitnumber
How many categories to return, from 1 to 5000. Leave empty for all of them.From 1 to 5000.
For coins (IDs)idstext
Only the categories that include these coins, by CoinMarketCap ID, separated by commas (for example, 5426 for Solana). Give IDs, symbols or slugs, or none for every category.
For coins (symbols)symboltext
Only the categories that include these coins, by ticker symbol (for example, SOL). A symbol stands for every coin using it, Wrapped Solana's categories included.
For coins (slugs)slugtext
Only the categories that include these coins, by the name in their coinmarketcap.com address (for example, solana).

Outputs

categoriesobject
CoinMarketCap's answer.
Example output
{
  "categories": {
    "data": [
      {
        "avg_price_change": 1.7673767812609038,
        "description": "The File-sharing category includes decentralized protocols enabling peer-to-peer file sharing and distribution over blockchain networks, providing censorship-resistant alternatives to centralized file hosting services.",
        "id": "6051a82066fc1b42617d6dc0",
        "last_updated": "2021-11-10T10:35:12.354Z",
        "market_cap": 1971951198.6788714,
        "market_cap_change": 1.336154350147,
        "name": "Filesharing",
        "num_tokens": 51,
        "title": "Filesharing",
        "volume": 239017455.0854476,
        "volume_change": -9.209245079644
      },
      {
        "avg_price_change": -0.2178459563906621,
        "description": "The Winklevoss Capital Portfolio category tracks tokens that have received investment from Winklevoss Capital, the investment firm of Bitcoin pioneers and Gemini exchange co-founders Tyler and Cameron Winklevoss.",
        "id": "605e2d3ed41eae1066535f7d",
        "last_updated": "2021-11-10T17:49:59.639Z",
        "market_cap": 2038448789523.1687,
        "market_cap_change": -0.258414866621,
        "name": "Winklevoss Capital Portfolio",
        "num_tokens": 6,
        "title": "Winklevoss Capital Portfolio",
        "volume": 51169153346.15509,
        "volume_change": -1.917777465733
      }
    ],
    "status": {
      "credit_count": 1,
      "elapsed": 2,
      "error_code": 0,
      "error_message": null,
      "notice": null,
      "timestamp": "2026-09-25T17:55:26.942Z"
    }
  }
}

Look up coin IDs

Find the CoinMarketCap ID for a ticker symbol, or list coins with their IDs. Several coins can share a symbol, so the best match comes first: active coins by market cap rank. The other actions take these IDs.

Inputs

Symbolssymboltext
The ticker symbols to look up, separated by commas (for example, BTC,ETH). Every coin with them comes back, and Start rank, Limit, Sort by and Listing status are ignored. Leave empty to list coins instead.
Limitlimitnumber
How many coins to list, from 1 to 5000. Leave empty for all of them, over 8,000. Ignored when symbols are given.From 1 to 5000.
Startstartnumber
The position in the list to start from, counting from 1. Ignored when symbols are given.At least 1.
Sort bysorttext
How to order the list: by CoinMarketCap ID (the default, oldest first) or by market cap rank. Ignored when symbols are given.One of: id (CoinMarketCap ID), cmc_rank (Market cap rank).
Listing statuslisting_statustext
Which coins to list: active ones (the default), inactive ones no longer traded, or untracked ones CoinMarketCap lists without market data. Ignored when symbols are given.One of: active (Active coins), inactive (Inactive coins), untracked (Untracked coins).

Outputs

mapobject
CoinMarketCap's answer.
Example output
{
  "map": {
    "data": [
      {
        "first_historical_data": "2020-04-10T04:55:00.000Z",
        "id": 5426,
        "is_active": 1,
        "last_historical_data": "2026-09-25T17:40:00.000Z",
        "name": "Solana",
        "platform": null,
        "rank": 7,
        "slug": "solana",
        "symbol": "SOL"
      },
      {
        "first_historical_data": "2022-01-17T19:40:00.000Z",
        "id": 16116,
        "is_active": 1,
        "last_historical_data": "2026-09-25T17:40:00.000Z",
        "name": "Wrapped Solana",
        "platform": {
          "id": 16,
          "name": "Solana",
          "slug": "solana",
          "symbol": "SOL",
          "token_address": "So11111111111111111111111111111111111111112"
        },
        "rank": 8023,
        "slug": "wrapped-solana",
        "symbol": "SOL"
      }
    ],
    "status": {
      "credit_count": 1,
      "elapsed": 1,
      "error_code": 0,
      "error_message": null,
      "notice": null,
      "timestamp": "2026-09-25T17:42:17.611Z"
    }
  }
}

Search DEX tokens

Search tokens traded on decentralized exchanges by name, symbol or contract address, with each one's network, price, liquidity and 24 hour change. Covers far more tokens than the listings.

Inputs

Search forquerytextRequired
A token's name, symbol or contract address (for example, pepe).
Networkplatformtext
The token's network, by CoinMarketCap's short name for it: ethereum, solana, bsc (BNB Smart Chain) or base, for example. Leave empty to search every network.
Limitlimitnumber
How many tokens to return, from 1 to 100. Leave empty for 50.From 1 to 100.

Outputs

searchobject
CoinMarketCap's answer.
Example output
{
  "search": {
    "data": {
      "tokens": [
        {
          "address": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
          "coinmarketcap_id": 24478,
          "decimals": 18,
          "fully_diluted_value_usd": null,
          "liquidity_usd": 34886620.01728861,
          "logo": "https://s2.coinmarketcap.com/static/img/coins/64x64/24478.png",
          "market_cap_usd": 1856164451.818193,
          "name": "Pepe",
          "network": "Ethereum",
          "network_coin_id": 1027,
          "network_id": 1,
          "percent_change_24h": -0.29,
          "price_usd": 4.4121916247197866e-06,
          "symbol": "PEPE",
          "total_supply": 420689899645071.7,
          "twitter": "https://twitter.com/pepecoineth",
          "updated_at": "2026-09-25T18:01:59Z",
          "volume_24h_usd": 2223110.2924201027,
          "website": "https://www.pepe.vip/"
        },
        {
          "address": "0xbe042e9d09cb588331ff911c2b46fd833a3e5bd6",
          "coinmarketcap_id": 27928,
          "decimals": 18,
          "fully_diluted_value_usd": null,
          "liquidity_usd": 32484.46367845447,
          "logo": "https://s2.coinmarketcap.com/static/img/coins/64x64/27928.png",
          "market_cap_usd": 293985.76416232646,
          "name": "Pepe",
          "network": "Ethereum",
          "network_coin_id": 1027,
          "network_id": 1,
          "percent_change_24h": 1.48,
          "price_usd": 0.0002939857641623265,
          "symbol": "PEPE",
          "total_supply": 1000000000.0,
          "twitter": "https://twitter.com/PepeToken_0xBE",
          "updated_at": "2026-09-25T08:47:11Z",
          "volume_24h_usd": 738.794957910186,
          "website": "https://pepecommunity.vip/"
        }
      ],
      "total": 3
    },
    "status": {
      "credit_count": 1,
      "elapsed": 199,
      "error_code": "0",
      "error_message": "",
      "timestamp": "2026-09-25T18:04:19.515Z"
    }
  }
}

On this page