# CoinMarketCap > 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. App · Cryptocurrency · 17 actions. Web page: https://docs.lodol.com/docs/integrations/coinmarketcap ## Actions ### 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 (`platform`, text, required): The token's network, by CoinMarketCap's short name for it: ethereum, solana, bsc (BNB Smart Chain) or base, for example. - Contract address (`address`, text, required): The token's contract address on that network. "Search DEX tokens" finds it from a name or symbol. **Outputs** - `security` (object): CoinMarketCap's answer. **Example output** ```json { "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 (`amount`, number, required): How much to convert (for example, 0.5). From 1e-08 to 1000000000000. - Symbol (`symbol`, text): 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_id`, text): What to convert from, by CoinMarketCap ID (for example, 1027 for Ethereum). Give a symbol or an ID. - Convert to (`convert`, text): The currency to convert into, as a code such as EUR, or a coin's symbol such as ETH. Defaults to USD. - At time (`time`, date 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** - `conversion` (object): CoinMarketCap's answer. **Example output** ```json { "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_id`, text, required): The category's ID, from "List categories" (for example, 6051a82566fc1b42617d6dc6 for Memes). - Start (`start`, number): The position among the category's coins to start from, counting from 1. At least 1. - Limit (`limit`, number): How many of the category's coins to return, from 1 to 1000. Leave empty for 100. From 1 to 1000. - Currency (`convert`, text): 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** - `category` (object): CoinMarketCap's answer. **Example output** ```json { "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_season` (object): CoinMarketCap's answer. **Example output** ```json { "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** - `index` (object): CoinMarketCap's answer. **Example output** ```json { "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** - `index` (object): CoinMarketCap's answer. **Example output** ```json { "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 (`ids`, text): 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 (`symbol`, text): 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 (`slug`, text): The coins by the name in their coinmarketcap.com address, separated by commas (for example, bitcoin,solana). Give IDs, symbols or slugs. **Outputs** - `info` (object): CoinMarketCap's answer. **Example output** ```json { "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 (`ids`, text): 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 (`symbol`, text): 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 (`slug`, text): The coins by the name in their coinmarketcap.com address, separated by commas (for example, bitcoin,solana). Give IDs, symbols or slugs. - Currencies (`convert`, text): 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_cap`, true/false): Set to true to add each coin's market cap. - Include 24 hour volume (`include_24h_volume`, true/false): Set to true to add each coin's trading volume over the last 24 hours. - Include 24 hour change (`include_24h_change`, true/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_updated`, true/false): Set to true to add when each price was last updated. **Outputs** - `prices` (object): CoinMarketCap's answer. **Example output** ```json { "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 (`platform`, text, required): The token's network, by CoinMarketCap's short name for it: ethereum, solana, bsc (BNB Smart Chain) or base, for example. - Contract address (`address`, text, required): The token's contract address on that network. "Search DEX tokens" finds it from a name or symbol. **Outputs** - `price` (object): CoinMarketCap's answer. **Example output** ```json { "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 (`start`, number): How many days back to start from, counting from 1 for the most recent day. At least 1. - Days (`limit`, number): How many days to return, from 1 to 500. Leave empty for 50. From 1 to 500. **Outputs** - `history` (object): CoinMarketCap's answer. **Example output** ```json { "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_greed` (object): CoinMarketCap's answer. **Example output** ```json { "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 (`convert`, text): 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** - `metrics` (object): CoinMarketCap's answer. **Example output** ```json { "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 (`symbol`, text): 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 (`ids`, text): 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 (`slug`, text): The coins by the name in their coinmarketcap.com address, separated by commas (for example, bitcoin,solana). Give IDs, symbols or slugs. - Currency (`convert`, text): The currency to show values in (for example, USD or EUR). Defaults to USD. One currency at a time. **Outputs** - `quotes` (object): CoinMarketCap's answer. **Example output** ```json { "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 (`start`, number): 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 (`limit`, number): How many coins to return, from 1 to 5000. Leave empty for 100. From 1 to 5000. - Currency (`convert`, text): The currency to show values in (for example, USD or EUR). Defaults to USD. One currency at a time. - Sort by (`sort`, text): 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_dir`, text): Highest first (the default) or lowest first. One of: `desc` (Highest first), `asc` (Lowest first). - Type (`cryptocurrency_type`, text): 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 (`tag`, text): 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_min`, number): 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_max`, number): 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_min`, number): 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_max`, number): 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_min`, number): 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_max`, number): 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_min`, number): 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_max`, number): 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** - `listings` (object): CoinMarketCap's answer. **Example output** ```json { "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 (`start`, number): The position in the list to start from, counting from 1. At least 1. - Limit (`limit`, number): How many categories to return, from 1 to 5000. Leave empty for all of them. From 1 to 5000. - For coins (IDs) (`ids`, text): 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) (`symbol`, text): 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) (`slug`, text): Only the categories that include these coins, by the name in their coinmarketcap.com address (for example, solana). **Outputs** - `categories` (object): CoinMarketCap's answer. **Example output** ```json { "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 (`symbol`, text): 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 (`limit`, number): 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 (`start`, number): The position in the list to start from, counting from 1. Ignored when symbols are given. At least 1. - Sort by (`sort`, text): 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_status`, text): 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** - `map` (object): CoinMarketCap's answer. **Example output** ```json { "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 (`query`, text, required): A token's name, symbol or contract address (for example, pepe). - Network (`platform`, text): 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 (`limit`, number): How many tokens to return, from 1 to 100. Leave empty for 50. From 1 to 100. **Outputs** - `search` (object): CoinMarketCap's answer. **Example output** ```json { "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" } } } ```