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
| Action | What it does |
|---|---|
| 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. |
| 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. |
| Get a category's coins | Get one coin category's figures and the coins in it, with their market data, largest first. |
| 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. |
| 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. |
| 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. |
| Get coin info | Get a coin's profile: its description, logo, website and social links, tags, launch date, and contract addresses. |
| 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). |
| Get DEX token price | Get a token's latest price on decentralized exchanges from its contract address and network. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| Look up coin IDs | Find the CoinMarketCap ID for a ticker symbol, or list coins with their IDs. |
| 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. |
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
- Network
platformtextRequired - The token's network, by CoinMarketCap's short name for it: ethereum, solana, bsc (BNB Smart Chain) or base, for example.
- Contract address
addresstextRequired - 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
- Amount
amountnumberRequired - How much to convert (for example, 0.5).From 1e-08 to 1000000000000.
- Symbol
symboltext - 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 ID
coin_idtext - What to convert from, by CoinMarketCap ID (for example, 1027 for Ethereum). Give a symbol or an ID.
- Convert to
converttext - The currency to convert into, as a code such as EUR, or a coin's symbol such as ETH. Defaults to USD.
- At time
timedate 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 ID
category_idtextRequired - The category's ID, from "List categories" (for example, 6051a82566fc1b42617d6dc6 for Memes).
- Start
startnumber - The position among the category's coins to start from, counting from 1.At least 1.
- Limit
limitnumber - How many of the category's coins to return, from 1 to 1000. Leave empty for 100.From 1 to 1000.
- Currency
converttext - 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 IDs
idstext - 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.
- Symbols
symboltext - 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.
- Slugs
slugtext - 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 IDs
idstext - 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.
- Symbols
symboltext - 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.
- Slugs
slugtext - The coins by the name in their coinmarketcap.com address, separated by commas (for example, bitcoin,solana). Give IDs, symbols or slugs.
- Currencies
converttext - 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 cap
include_market_captrue/false - Set to true to add each coin's market cap.
- Include 24 hour volume
include_24h_volumetrue/false - Set to true to add each coin's trading volume over the last 24 hours.
- Include 24 hour change
include_24h_changetrue/false - Set to true to add how much each coin's price changed over the last 24 hours, in percent.
- Include last updated
include_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
- Network
platformtextRequired - The token's network, by CoinMarketCap's short name for it: ethereum, solana, bsc (BNB Smart Chain) or base, for example.
- Contract address
addresstextRequired - 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
- Start
startnumber - How many days back to start from, counting from 1 for the most recent day.At least 1.
- Days
limitnumber - 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
- Currency
converttext - 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
- Symbols
symboltext - 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 IDs
idstext - 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.
- Slugs
slugtext - The coins by the name in their coinmarketcap.com address, separated by commas (for example, bitcoin,solana). Give IDs, symbols or slugs.
- Currency
converttext - 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 rank
startnumber - 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.
- Limit
limitnumber - How many coins to return, from 1 to 5000. Leave empty for 100.From 1 to 5000.
- Currency
converttext - The currency to show values in (for example, USD or EUR). Defaults to USD. One currency at a time.
- Sort by
sorttext - 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 direction
sort_dirtext - Highest first (the default) or lowest first.One of:
desc(Highest first),asc(Lowest first). - Type
cryptocurrency_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). - Tag
tagtext - 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
- Start
startnumber - The position in the list to start from, counting from 1.At least 1.
- Limit
limitnumber - 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
- Symbols
symboltext - 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.
- Limit
limitnumber - 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.
- Start
startnumber - The position in the list to start from, counting from 1. Ignored when symbols are given.At least 1.
- Sort by
sorttext - 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 status
listing_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 for
querytextRequired - A token's name, symbol or contract address (for example, pepe).
- Network
platformtext - 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.
- Limit
limitnumber - 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"
}
}
}